@orquentra/codebuddy 2.9.0 → 2.15.0

package/dist/{chunk-TLWGZVPC.js → chunk-UR3DF74I.js}

@@ -1,37 +1,702 @@
 import {
-  loadArchitectureMap,
-  loadFreshIndex
-} from "./chunk-ITQO632W.js";
+  extractPythonImports,
+  extractSymbolTable,
+  supportsSymbols
+} from "./chunk-Y7D7PUBE.js";
 import {
   isCredentialPath
 } from "./chunk-AL6VBTNA.js";
-import {
-  LOCAL_EMBEDDING_MODEL
-} from "./chunk-HPOR6YXA.js";
 import {
   readConfigFile
-} from "./chunk-KNR2P2UY.js";
+} from "./chunk-M75SN4D4.js";
 import {
+  assertNoSymlinkBetween,
   writeAtomic
 } from "./chunk-CG5B3LYG.js";
+import {
+  LOCAL_EMBEDDING_MODEL
+} from "./chunk-HPOR6YXA.js";
+
+// src/context/file-vectors.ts
+import { createHash as createHash3 } from "crypto";
+import { mkdir as mkdir5, readFile as readFile10 } from "fs/promises";
+import { dirname as dirname6, join as join9 } from "path";
+
+// src/indexer/engine.ts
+import { createHash } from "crypto";
+import { readFile as readFile4, stat as stat2 } from "fs/promises";
+import { join as join5, resolve as resolve4 } from "path";
+
+// src/map/cache.ts
+import { mkdir as mkdir2, readFile as readFile3 } from "fs/promises";
+import { dirname as dirname3, extname as extname2, join as join3, resolve as resolve3 } from "path";
+
+// src/indexer/store.ts
+import { mkdir, readFile } from "fs/promises";
+import { dirname, join, resolve } from "path";
+import { z } from "zod";
+
+// src/indexer/types.ts
+var INDEX_MANIFEST_VERSION = 3;
+
+// src/indexer/store.ts
+var symbolSpanSchema = z.object({
+  name: z.string(),
+  kind: z.enum(["function", "method", "class", "interface", "type", "enum", "const", "heading"]),
+  startLine: z.number().int().nonnegative(),
+  endLine: z.number().int().nonnegative(),
+  signature: z.string(),
+  exported: z.boolean()
+});
+var entrySchema = z.object({
+  path: z.string(),
+  hash: z.string(),
+  size: z.number().int().nonnegative(),
+  mtimeMs: z.number().optional(),
+  ctimeMs: z.number().optional(),
+  language: z.string(),
+  lines: z.number().int().nonnegative(),
+  symbols: z.array(z.string()),
+  symbolTable: z.array(symbolSpanSchema).optional(),
+  summary: z.string(),
+  indexedAt: z.string()
+});
+var manifestSchema = z.object({
+  version: z.literal(INDEX_MANIFEST_VERSION),
+  generatedAt: z.string(),
+  entries: z.record(z.string(), entrySchema)
+});
+var IndexStore = class {
+  repositoryRoot;
+  cacheDirectory;
+  manifestPath;
+  constructor(repositoryRoot = process.cwd()) {
+    this.repositoryRoot = resolve(repositoryRoot);
+    this.cacheDirectory = join(this.repositoryRoot, ".codebuddy", "cache");
+    this.manifestPath = join(this.cacheDirectory, "index.json");
+  }
+  /** Read the manifest, or an empty one if absent/corrupt/version-mismatched. */
+  async read() {
+    try {
+      const raw = await readFile(this.manifestPath, "utf8");
+      const parsed = manifestSchema.safeParse(JSON.parse(raw));
+      if (!parsed.success) return emptyManifest();
+      return parsed.data;
+    } catch (error) {
+      if (error.code === "ENOENT") return emptyManifest();
+      return emptyManifest();
+    }
+  }
+  async write(manifest) {
+    await assertNoSymlinkBetween(this.repositoryRoot, dirname(this.manifestPath));
+    await mkdir(this.cacheDirectory, { recursive: true, mode: 448 });
+    await writeAtomic(this.manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  }
+};
+function emptyManifest() {
+  return { version: INDEX_MANIFEST_VERSION, generatedAt: (/* @__PURE__ */ new Date(0)).toISOString(), entries: {} };
+}
+
+// src/map/indexer.ts
+import { readdir, readFile as readFile2, stat } from "fs/promises";
+import { dirname as dirname2, extname, join as join2, relative, resolve as resolve2 } from "path";
+var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py"]);
+var IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  "dist",
+  "build",
+  "coverage",
+  ".codebuddy",
+  // Python virtualenvs and caches would otherwise map site-packages.
+  ".venv",
+  "venv",
+  ".tox",
+  "__pycache__"
+]);
+async function buildArchitectureMap(repositoryRoot = process.cwd()) {
+  const root = resolve2(repositoryRoot);
+  const files = await listSourceFiles(root);
+  const fileSet = new Set(files.map((file) => normalize(relative(root, file))));
+  const modules = [];
+  const edges = [];
+  for (const absolutePath of files) {
+    const source = await readFile2(absolutePath, "utf8");
+    const from = normalize(relative(root, absolutePath));
+    const resolvedImports = moduleImports(root, from, source, fileSet);
+    edges.push(...resolvedImports.map(({ to, kind }) => ({ from, to, kind })));
+    modules.push({
+      path: from,
+      language: moduleLanguage(from),
+      imports: [...new Set(resolvedImports.map(({ to }) => to))].sort()
+    });
+  }
+  return {
+    modules: modules.sort((left, right) => left.path.localeCompare(right.path)),
+    edges: edges.sort(
+      (left, right) => `${left.from}:${left.to}`.localeCompare(`${right.from}:${right.to}`)
+    )
+  };
+}
+async function updateArchitectureMap(repositoryRoot, sourcePaths, previous, changedPaths) {
+  const root = resolve2(repositoryRoot);
+  const normalizedPaths = sourcePaths.map(normalize).sort();
+  const fileSet = new Set(normalizedPaths);
+  const changed = new Set(changedPaths.map(normalize));
+  const retainedModules = (previous?.modules ?? []).filter(
+    (module) => fileSet.has(module.path) && !changed.has(module.path)
+  );
+  const retainedEdges = (previous?.edges ?? []).filter(
+    (edge) => fileSet.has(edge.from) && fileSet.has(edge.to) && !changed.has(edge.from)
+  );
+  const modules = [...retainedModules];
+  const edges = [...retainedEdges];
+  for (const path of normalizedPaths) {
+    if (!changed.has(path)) continue;
+    const source = await readFile2(join2(root, path), "utf8");
+    const resolvedImports = moduleImports(root, path, source, fileSet);
+    edges.push(...resolvedImports.map(({ to, kind }) => ({ from: path, to, kind })));
+    modules.push({
+      path,
+      language: moduleLanguage(path),
+      imports: [...new Set(resolvedImports.map(({ to }) => to))].sort()
+    });
+  }
+  return {
+    map: {
+      modules: modules.sort((left, right) => left.path.localeCompare(right.path)),
+      edges: edges.sort(
+        (left, right) => `${left.from}:${left.to}`.localeCompare(`${right.from}:${right.to}`)
+      )
+    },
+    stats: {
+      readFiles: changed.size,
+      reusedFiles: retainedModules.length,
+      rebuilt: previous === null || changed.size === normalizedPaths.length
+    }
+  };
+}
+function queryMap(map, query) {
+  const limit = query.limit ?? 50;
+  return map.edges.filter((edge) => query.from ? edge.from === normalize(query.from) : true).filter((edge) => query.to ? edge.to === normalize(query.to) : true).slice(0, limit);
+}
+function neighbours(map, modulePath, direction = "both") {
+  const target = normalize(modulePath);
+  const edges = map.edges.filter((edge) => {
+    if (direction === "in") return edge.to === target;
+    if (direction === "out") return edge.from === target;
+    return edge.from === target || edge.to === target;
+  });
+  const paths = /* @__PURE__ */ new Set([target]);
+  for (const edge of edges) {
+    paths.add(edge.from);
+    paths.add(edge.to);
+  }
+  return {
+    modules: map.modules.filter((module) => paths.has(module.path)),
+    edges
+  };
+}
+async function listSourceFiles(root) {
+  const files = [];
+  await walk(root, files);
+  return files.sort();
+}
+async function walk(directory, files) {
+  const entries = await readdir(directory, { withFileTypes: true });
+  for (const entry of entries) {
+    const absolute = join2(directory, entry.name);
+    if (entry.isDirectory()) {
+      if (IGNORED_DIRECTORIES.has(entry.name)) continue;
+      await walk(absolute, files);
+      continue;
+    }
+    if (!entry.isFile()) continue;
+    if (!SUPPORTED_EXTENSIONS.has(extname(entry.name))) continue;
+    const info = await stat(absolute);
+    if (info.size > 5e5) continue;
+    files.push(absolute);
+  }
+}
+function moduleLanguage(path) {
+  const extension = extname(path);
+  if (extension === ".py") return "py";
+  return extension.includes("ts") ? "ts" : "js";
+}
+function moduleImports(root, from, source, fileSet) {
+  if (extname(from) === ".py") {
+    return pythonImports(from, source, fileSet).map((to) => ({ to, kind: "import" }));
+  }
+  return extractImports(source).flatMap((specifier) => {
+    const to = resolveImport(root, from, specifier.value, fileSet);
+    return to ? [{ to, kind: specifier.kind }] : [];
+  });
+}
+var PYTHON_ROOTS = ["", "src/"];
+function pythonImports(from, source, fileSet) {
+  const pick = (...candidates) => candidates.find((candidate) => fileSet.has(candidate)) ?? null;
+  const moduleFile = (base) => pick(`${base}.py`, `${base}/__init__.py`);
+  const packageDir = from.split("/").slice(0, -1);
+  const targets = [];
+  for (const statement of extractPythonImports(source)) {
+    const parts = statement.module ? statement.module.split(".") : [];
+    let bases;
+    if (statement.level > 0) {
+      const up = statement.level - 1;
+      if (up > packageDir.length) continue;
+      bases = [[...packageDir.slice(0, packageDir.length - up), ...parts].join("/")];
+    } else {
+      bases = PYTHON_ROOTS.map((prefix) => `${prefix}${parts.join("/")}`);
+    }
+    for (const base of bases) {
+      const prefix = base ? `${base}/` : "";
+      const module = parts.length > 0 ? moduleFile(base) : pick(`${prefix}__init__.py`);
+      const submodules = statement.names.flatMap((name) => moduleFile(`${prefix}${name}`) ?? []);
+      if (!module && submodules.length === 0) continue;
+      targets.push(...submodules);
+      if (module && submodules.length < Math.max(1, statement.names.length)) targets.push(module);
+      break;
+    }
+  }
+  return [...new Set(targets)].filter((target) => target !== from);
+}
+function extractImports(source) {
+  const imports = [];
+  const stripped = source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1 ");
+  const staticImport = /\bimport\s+(?:type\s+)?(?:[^'"()+]+?\s+from\s+)?["']([^"']+)["']/g;
+  const exportFrom = /\bexport\s+[^'"()+]+?\s+from\s+["']([^"']+)["']/g;
+  const dynamicImport = /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g;
+  for (const match of stripped.matchAll(staticImport)) {
+    if (match[1]) imports.push({ value: match[1], kind: "import" });
+  }
+  for (const match of stripped.matchAll(exportFrom)) {
+    if (match[1]) imports.push({ value: match[1], kind: "import" });
+  }
+  for (const match of stripped.matchAll(dynamicImport)) {
+    if (match[1]) imports.push({ value: match[1], kind: "dynamic_import" });
+  }
+  return imports;
+}
+function resolveImport(root, from, specifier, fileSet) {
+  if (!specifier.startsWith(".")) return null;
+  const base = normalize(relative(root, resolve2(root, dirname2(from), specifier)));
+  const stem = base.replace(/\.(js|jsx|mjs|cjs)$/, "");
+  const bases = stem === base ? [base] : [base, stem];
+  const candidates = bases.flatMap((b) => [
+    b,
+    `${b}.ts`,
+    `${b}.tsx`,
+    `${b}.js`,
+    `${b}.jsx`,
+    `${b}.mjs`,
+    `${b}.cjs`,
+    `${b}/index.ts`,
+    `${b}/index.tsx`,
+    `${b}/index.js`,
+    `${b}/index.jsx`
+  ]);
+  return candidates.find((candidate) => fileSet.has(candidate)) ?? null;
+}
+function normalize(path) {
+  return path.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+
+// src/map/cache.ts
+var CACHE_VERSION = 1;
+var SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py"]);
+async function loadArchitectureMap(repositoryRoot = process.cwd(), suppliedManifest) {
+  const root = resolve3(repositoryRoot);
+  const manifest = suppliedManifest ?? await new IndexStore(root).read();
+  if (Object.keys(manifest.entries).length === 0) {
+    const map = await buildArchitectureMap(root);
+    return {
+      map,
+      stats: { readFiles: map.modules.length, reusedFiles: 0, rebuilt: true },
+      source: "fallback"
+    };
+  }
+  return refreshArchitectureCache(root, manifest);
+}
+async function refreshArchitectureCache(repositoryRoot, manifest) {
+  const root = resolve3(repositoryRoot);
+  const path = join3(root, ".codebuddy", "cache", "architecture.json");
+  const currentHashes = sourceHashes(manifest);
+  const currentPaths = Object.keys(currentHashes).sort();
+  const cached = await readCache(path);
+  const cachedPaths = cached ? Object.keys(cached.sourceHashes).sort() : [];
+  const fileSetChanged = cachedPaths.join("\n") !== currentPaths.join("\n");
+  const changedPaths = !cached || fileSetChanged ? currentPaths : currentPaths.filter(
+    (sourcePath) => cached.sourceHashes[sourcePath] !== currentHashes[sourcePath]
+  );
+  if (cached && changedPaths.length === 0) {
+    return {
+      map: cached.map,
+      stats: { readFiles: 0, reusedFiles: cached.map.modules.length, rebuilt: false },
+      source: "cache"
+    };
+  }
+  const updated = await updateArchitectureMap(
+    root,
+    currentPaths,
+    fileSetChanged ? null : cached?.map ?? null,
+    changedPaths
+  );
+  const next = {
+    version: CACHE_VERSION,
+    generatedAt: manifest.generatedAt,
+    sourceHashes: currentHashes,
+    map: updated.map
+  };
+  await assertNoSymlinkBetween(root, dirname3(path));
+  await mkdir2(dirname3(path), { recursive: true, mode: 448 });
+  await writeAtomic(path, `${JSON.stringify(next, null, 2)}
+`);
+  return { ...updated, source: fileSetChanged || !cached ? "rebuild" : "incremental" };
+}
+async function readCache(path) {
+  try {
+    const parsed = JSON.parse(await readFile3(path, "utf8"));
+    if (parsed.version !== CACHE_VERSION || !parsed.map || !parsed.sourceHashes) return null;
+    if (!Array.isArray(parsed.map.modules) || !Array.isArray(parsed.map.edges)) return null;
+    if (!parsed.map.modules.every(
+      (module) => module && typeof module.path === "string" && typeof module.language === "string" && Array.isArray(module.imports)
+    ) || !parsed.map.edges.every(
+      (edge) => edge && typeof edge.from === "string" && typeof edge.to === "string"
+    )) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function sourceHashes(manifest) {
+  return Object.fromEntries(
+    Object.values(manifest.entries).filter((entry) => SOURCE_EXTENSIONS.has(extname2(entry.path).toLowerCase())).map((entry) => [entry.path, entry.hash])
+  );
+}
+
+// src/indexer/scan.ts
+import { spawn } from "child_process";
+import { readdir as readdir2 } from "fs/promises";
+import { extname as extname4, join as join4, relative as relative2, sep } from "path";
+
+// src/indexer/summary.ts
+import { extname as extname3 } from "path";
+var LANGUAGE_BY_EXTENSION = {
+  ".ts": "ts",
+  ".tsx": "tsx",
+  ".js": "js",
+  ".jsx": "jsx",
+  ".mjs": "js",
+  ".cjs": "js",
+  ".json": "json",
+  ".md": "md",
+  ".mdx": "md",
+  ".rst": "rst",
+  ".yaml": "yaml",
+  ".yml": "yaml",
+  ".toml": "toml",
+  ".css": "css",
+  ".scss": "scss",
+  ".html": "html",
+  ".py": "py",
+  ".go": "go",
+  ".rs": "rust",
+  ".java": "java",
+  ".rb": "ruby",
+  ".php": "php",
+  ".sh": "shell",
+  ".sql": "sql",
+  ".txt": "text"
+};
+var SUPPORTED_EXTENSIONS2 = new Set(Object.keys(LANGUAGE_BY_EXTENSION));
+var CODE_LANGUAGES = /* @__PURE__ */ new Set(["ts", "tsx", "js", "jsx"]);
+var SYMBOL_LIMIT = 8;
+var SUMMARY_COMMENT_MAX = 80;
+function languageFor(path) {
+  return LANGUAGE_BY_EXTENSION[extname3(path).toLowerCase()] ?? "text";
+}
+function summarizeSource(path, content) {
+  const language = languageFor(path);
+  const lines = countLines(content);
+  const symbols = CODE_LANGUAGES.has(language) ? extractSymbols(content) : language === "py" ? pythonPublicNames(content) : [];
+  const summary = composeSummary(language, lines, symbols, content);
+  return { language, lines, symbols, summary };
+}
+function countLines(content) {
+  if (content.length === 0) return 0;
+  return content.replace(/\r/g, "").replace(/\n$/, "").split("\n").length;
+}
+function extractSymbols(content) {
+  const names = [];
+  const push = (name) => {
+    const trimmed = name?.trim();
+    if (trimmed && /^[A-Za-z_$][\w$]*$/.test(trimmed) && !names.includes(trimmed)) {
+      names.push(trimmed);
+    }
+  };
+  const declaration = /^export\s+(?:default\s+)?(?:async\s+)?(?:abstract\s+)?(?:const|let|var|function|class|interface|type|enum)\s+([A-Za-z_$][\w$]*)/gm;
+  for (const match of content.matchAll(declaration)) push(match[1]);
+  const namedExports = /^export\s*\{([^}]*)\}/gm;
+  for (const match of content.matchAll(namedExports)) {
+    for (const part of (match[1] ?? "").split(",")) {
+      const alias = part.includes(" as ") ? part.split(" as ").pop() : part;
+      push(alias);
+    }
+  }
+  return names.slice(0, SYMBOL_LIMIT);
+}
+function pythonPublicNames(content) {
+  return extractSymbolTable(content, "x.py").filter((symbol) => symbol.exported && symbol.kind !== "method").map((symbol) => symbol.name).slice(0, SYMBOL_LIMIT);
+}
+function composeSummary(language, lines, symbols, content) {
+  const head = `${language} \u2022 ${lines} line${lines === 1 ? "" : "s"}`;
+  if (symbols.length > 0) return `${head} \u2022 exports ${symbols.join(", ")}`;
+  const comment = leadingComment(content);
+  if (comment) return `${head} \u2022 ${comment}`;
+  return head;
+}
+function leadingComment(content) {
+  for (const raw of content.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (line === "") continue;
+    const stripped = line.replace(/^\/\/+/, "").replace(/^\/\*+/, "").replace(/\*+\/$/, "").replace(/^[#*]+/, "").trim();
+    if (line.startsWith("//") || line.startsWith("/*") || line.startsWith("#") || line.startsWith("*")) {
+      if (stripped) return truncate(stripped, SUMMARY_COMMENT_MAX);
+      continue;
+    }
+    return null;
+  }
+  return null;
+}
+function truncate(value, max) {
+  return value.length <= max ? value : `${value.slice(0, max - 1)}\u2026`;
+}
+
+// src/indexer/scan.ts
+var FALLBACK_IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  "dist",
+  "build",
+  "coverage",
+  ".codebuddy",
+  "graphify-out",
+  ".next",
+  ".turbo",
+  "out",
+  ".venv",
+  "venv",
+  "__pycache__"
+]);
+async function listIndexableFiles(repositoryRoot) {
+  const tracked = await gitListFiles(repositoryRoot);
+  const paths = tracked ?? await walkFiles(repositoryRoot);
+  return paths.map(normalize2).filter((path) => !path.startsWith(".codebuddy/") && !path.startsWith("graphify-out/")).filter((path) => SUPPORTED_EXTENSIONS2.has(extname4(path).toLowerCase())).sort();
+}
+async function gitListFiles(repositoryRoot) {
+  const result = await runGit(repositoryRoot, [
+    "ls-files",
+    "-z",
+    "--cached",
+    "--others",
+    "--exclude-standard"
+  ]);
+  if (result.code !== 0) return null;
+  return result.stdout.split("\0").filter(Boolean);
+}
+async function walkFiles(root) {
+  const files = [];
+  const walk2 = async (directory) => {
+    const entries = await readdir2(directory, { withFileTypes: true });
+    for (const entry of entries) {
+      const absolute = join4(directory, entry.name);
+      if (entry.isDirectory()) {
+        if (FALLBACK_IGNORED_DIRECTORIES.has(entry.name)) continue;
+        await walk2(absolute);
+        continue;
+      }
+      if (entry.isFile()) files.push(relative2(root, absolute));
+    }
+  };
+  await walk2(root);
+  return files;
+}
+function runGit(cwd, args) {
+  return new Promise((resolveResult) => {
+    const child = spawn("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (chunk2) => {
+      stdout += String(chunk2);
+    });
+    child.stderr.on("data", (chunk2) => {
+      stderr += String(chunk2);
+    });
+    child.on("error", () => resolveResult({ code: -1, stdout: "", stderr: "git unavailable" }));
+    child.on("close", (code) => resolveResult({ code: code ?? 0, stdout, stderr }));
+  });
+}
+function normalize2(path) {
+  return (sep === "\\" ? path.replace(/\\/g, "/") : path).replace(/^\.\//, "");
+}
+
+// src/indexer/engine.ts
+var MAX_FILE_BYTES = 512e3;
+var RACY_WINDOW_MS = 3e3;
+async function indexRepository(options = {}) {
+  return (await refreshIndex(options)).result;
+}
+async function loadFreshIndex(repositoryRoot) {
+  try {
+    const { result, manifest } = await refreshIndex({ repositoryRoot });
+    const delta = result.added + result.changed + result.removed;
+    const failures = result.errors.length > 0 ? `; ${result.errors.length} file(s) could not be validated and were omitted` : "";
+    return {
+      manifest,
+      explain: delta === 0 ? `index: ${result.totalIndexed} indexed file(s) match current source${failures}` : `index: refreshed against current source (${result.changed} changed, ${result.added} added, ${result.removed} removed; ${result.totalIndexed} indexed)${failures}`
+    };
+  } catch (error) {
+    return {
+      manifest: emptyManifest(),
+      explain: `index: freshness check failed (${error.message}); indexed evidence omitted`
+    };
+  }
+}
+var passes = /* @__PURE__ */ new Map();
+function refreshIndex(options) {
+  const key = resolve4(options.repositoryRoot ?? process.cwd());
+  const next = (passes.get(key) ?? Promise.resolve()).catch(() => void 0).then(() => runIndexPass(options));
+  passes.set(key, next);
+  void next.finally(() => {
+    if (passes.get(key) === next) passes.delete(key);
+  }).catch(() => void 0);
+  return next;
+}
+async function runIndexPass(options) {
+  const start = Date.now();
+  const now = options.now ?? (() => /* @__PURE__ */ new Date());
+  const repositoryRoot = resolve4(options.repositoryRoot ?? process.cwd());
+  const store = new IndexStore(repositoryRoot);
+  const [files, previous] = await Promise.all([listIndexableFiles(repositoryRoot), store.read()]);
+  const entries = {};
+  const errors = [];
+  let added = 0;
+  let changed = 0;
+  let unchanged = 0;
+  let skipped = 0;
+  let dirty = previous.generatedAt === emptyManifest().generatedAt;
+  for (const path of files) {
+    try {
+      const info = await stat2(join5(repositoryRoot, path));
+      if (!info.isFile()) continue;
+      if (info.size > MAX_FILE_BYTES) {
+        skipped++;
+        continue;
+      }
+      const existing = previous.entries[path];
+      if (!options.full && existing && statUnchanged(existing, info)) {
+        entries[path] = existing;
+        unchanged++;
+        continue;
+      }
+      const content = await readFile4(join5(repositoryRoot, path), "utf8");
+      const hash = hashContent(content);
+      const metadata = trustedMetadata(info);
+      dirty = true;
+      if (!options.full && existing && existing.hash === hash) {
+        const { mtimeMs: _mtime, ctimeMs: _ctime, ...rest } = existing;
+        entries[path] = { ...rest, size: info.size, ...metadata };
+        unchanged++;
+        continue;
+      }
+      const { language, lines, symbols, summary } = summarizeSource(path, content);
+      const symbolTable = supportsSymbols(path) ? extractSymbolTable(content, path) : [];
+      entries[path] = {
+        path,
+        hash,
+        size: info.size,
+        ...metadata,
+        language,
+        lines,
+        symbols,
+        ...symbolTable.length > 0 ? { symbolTable } : {},
+        summary,
+        indexedAt: now().toISOString()
+      };
+      if (existing) changed++;
+      else added++;
+    } catch (error) {
+      errors.push({ path, error: error.message });
+      skipped++;
+    }
+  }
+  const removed = Object.keys(previous.entries).filter((path) => !(path in entries)).length;
+  const manifest = {
+    version: INDEX_MANIFEST_VERSION,
+    generatedAt: now().toISOString(),
+    entries: sortEntries(entries)
+  };
+  if (dirty || removed > 0) await store.write(manifest);
+  const architecture = await refreshArchitectureCache(repositoryRoot, manifest);
+  const result = {
+    scanned: files.length,
+    added,
+    changed,
+    unchanged,
+    removed,
+    skipped,
+    errors,
+    durationMs: Date.now() - start,
+    totalIndexed: Object.keys(entries).length,
+    architecture: {
+      source: architecture.source,
+      readFiles: architecture.stats.readFiles,
+      reusedFiles: architecture.stats.reusedFiles
+    }
+  };
+  return { result, manifest };
+}
+function statUnchanged(entry, info) {
+  return entry.mtimeMs !== void 0 && entry.size === info.size && entry.mtimeMs === info.mtimeMs && entry.ctimeMs === info.ctimeMs;
+}
+function trustedMetadata(info) {
+  if (Date.now() - Math.max(info.mtimeMs, info.ctimeMs) < RACY_WINDOW_MS) return {};
+  return { mtimeMs: info.mtimeMs, ctimeMs: info.ctimeMs };
+}
+function hashContent(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function sortEntries(entries) {
+  return Object.fromEntries(
+    Object.keys(entries).sort().map((key) => [key, entries[key]])
+  );
+}
+
+// src/context/discovery.ts
+import { readFile as readFile9, realpath, stat as stat4 } from "fs/promises";
+import { isAbsolute as isAbsolute3, join as join8, relative as relative6 } from "path";
 
 // src/integrations/graphify.ts
 import { execFile } from "child_process";
-import { mkdir, mkdtemp, readFile as readFile2, rm, stat, utimes } from "fs/promises";
+import { mkdir as mkdir3, mkdtemp, readFile as readFile6, rm, stat as stat3, utimes } from "fs/promises";
 import { tmpdir } from "os";
-import { dirname, join, relative, resolve, sep } from "path";
+import { dirname as dirname4, join as join6, relative as relative3, resolve as resolve5, sep as sep2 } from "path";
 import { promisify } from "util";
 
 // src/map/graph-freshness.ts
-import { createHash } from "crypto";
-import { readFile } from "fs/promises";
-var digest = (value) => createHash("sha256").update(value).digest("hex");
+import { createHash as createHash2 } from "crypto";
+import { readFile as readFile5 } from "fs/promises";
+var digest = (value) => createHash2("sha256").update(value).digest("hex");
 async function writeGraphSourceSnapshot(path, manifest) {
   await writeAtomic(
     `${path}.sources.json`,
     JSON.stringify({
       version: 1,
-      graphHash: digest(await readFile(path, "utf8")),
+      graphHash: digest(await readFile5(path, "utf8")),
       sources: Object.fromEntries(
         Object.values(manifest.entries).map((entry) => [entry.path, entry.hash])
       )
@@ -41,13 +706,13 @@ async function writeGraphSourceSnapshot(path, manifest) {
 async function readGraphSourceSnapshot(path) {
   let raw;
   try {
-    raw = await readFile(`${path}.sources.json`, "utf8");
+    raw = await readFile5(`${path}.sources.json`, "utf8");
   } catch (error) {
     return error.code === "ENOENT" ? null : {};
   }
   try {
     const snapshot = JSON.parse(raw);
-    if (snapshot.version !== 1 || snapshot.graphHash !== digest(await readFile(path, "utf8")) || !snapshot.sources || typeof snapshot.sources !== "object" || Array.isArray(snapshot.sources))
+    if (snapshot.version !== 1 || snapshot.graphHash !== digest(await readFile5(path, "utf8")) || !snapshot.sources || typeof snapshot.sources !== "object" || Array.isArray(snapshot.sources))
       return {};
     return Object.fromEntries(
       Object.entries(snapshot.sources).filter(
@@ -134,17 +799,17 @@ async function graphifyGraphExists(repositoryRoot, graphPath = DEFAULT_GRAPH_PAT
 }
 async function generateGraphifyGraph(options) {
   const run = options.run ?? runCommand;
-  const repositoryRoot = resolve(options.repositoryRoot);
+  const repositoryRoot = resolve5(options.repositoryRoot);
   const graphPath = options.graphPath ?? DEFAULT_GRAPH_PATH;
   const destination = resolveGraphPath(repositoryRoot, graphPath);
-  await mkdir(dirname(destination), { recursive: true });
-  await ignoreGeneratedGraphDirectory(dirname(destination));
+  await mkdir3(dirname4(destination), { recursive: true });
+  await ignoreGeneratedGraphDirectory(dirname4(destination));
   const { manifest: sourceSnapshot } = await loadFreshIndex(repositoryRoot);
   const current = await readGraphFileIfPresent(destination);
   const isDefaultPath = graphPath === DEFAULT_GRAPH_PATH;
   if (current && isDefaultPath) {
-    const backup = await readFile2(destination, "utf8");
-    const backupStat = await stat(destination);
+    const backup = await readFile6(destination, "utf8");
+    const backupStat = await stat3(destination);
     try {
       await run("graphify", ["update", repositoryRoot, "--force", "--no-cluster"], repositoryRoot);
       const updated = await readGraphFile(destination);
@@ -158,16 +823,16 @@ async function generateGraphifyGraph(options) {
       );
     }
   }
-  const stagingRoot = await mkdtemp(join(tmpdir(), "codebuddy-graphify-"));
+  const stagingRoot = await mkdtemp(join6(tmpdir(), "codebuddy-graphify-"));
   try {
     await run(
       "graphify",
       ["extract", repositoryRoot, "--out", stagingRoot, "--code-only", "--no-cluster"],
       repositoryRoot
     );
-    const stagedPath = join(stagingRoot, DEFAULT_GRAPH_PATH);
+    const stagedPath = join6(stagingRoot, DEFAULT_GRAPH_PATH);
     const staged = await readGraphFile(stagedPath);
-    await writeAtomic(destination, await readFile2(stagedPath, "utf8"));
+    await writeAtomic(destination, await readFile6(stagedPath, "utf8"));
     await writeGraphSourceSnapshot(destination, sourceSnapshot);
     return { graphPath, generated: true, ...staged };
   } finally {
@@ -175,17 +840,17 @@ async function generateGraphifyGraph(options) {
   }
 }
 async function ignoreGeneratedGraphDirectory(directory) {
-  const path = join(directory, ".gitignore");
+  const path = join6(directory, ".gitignore");
   try {
-    await stat(path);
+    await stat3(path);
   } catch {
     await writeAtomic(path, "# CodeBuddy-generated Graphify output (derived, rebuildable)\n*\n");
   }
 }
 function resolveGraphPath(repositoryRoot, graphPath) {
-  const absolute = resolve(repositoryRoot, graphPath);
-  const relativePath = relative(repositoryRoot, absolute);
-  if (relativePath === "" || relativePath === ".." || relativePath.startsWith(`..${sep}`)) {
+  const absolute = resolve5(repositoryRoot, graphPath);
+  const relativePath = relative3(repositoryRoot, absolute);
+  if (relativePath === "" || relativePath === ".." || relativePath.startsWith(`..${sep2}`)) {
     throw new Error(`Graph path must be inside the project root: ${graphPath}`);
   }
   return absolute;
@@ -198,10 +863,10 @@ async function readGraphFileIfPresent(path) {
   }
 }
 async function readGraphFile(path) {
-  const info = await stat(path);
+  const info = await stat3(path);
   if (!info.isFile() || info.size === 0)
     throw new Error(`Graphify graph is missing or empty: ${path}`);
-  const raw = JSON.parse(await readFile2(path, "utf8"));
+  const raw = JSON.parse(await readFile6(path, "utf8"));
   const nodes = arrayLength(raw.nodes ?? raw.entities);
   const edges = arrayLength(raw.edges ?? raw.links ?? raw.relationships);
   if (nodes === 0) throw new Error(`Graphify graph contains no nodes: ${path}`);
@@ -211,17 +876,9 @@ function arrayLength(value) {
   return Array.isArray(value) ? value.length : 0;
 }
 
-// src/context/file-vectors.ts
-import { mkdir as mkdir3, readFile as readFile6 } from "fs/promises";
-import { dirname as dirname3, join as join4 } from "path";
-
-// src/context/discovery.ts
-import { readFile as readFile5, realpath, stat as stat2 } from "fs/promises";
-import { isAbsolute as isAbsolute3, join as join3, relative as relative4 } from "path";
-
 // src/map/graphify.ts
-import { readFile as readFile3 } from "fs/promises";
-import { isAbsolute, relative as relative2, resolve as resolve2 } from "path";
+import { readFile as readFile7 } from "fs/promises";
+import { isAbsolute, relative as relative4, resolve as resolve6 } from "path";
 var NON_DEPENDENCY_RELATIONS = /* @__PURE__ */ new Set([
   "contains",
   "part_of",
@@ -255,7 +912,7 @@ var DIRECT_DEPENDENCY_RELATIONS = /* @__PURE__ */ new Set([
 ]);
 var MAX_EDGE_SYMBOLS = 8;
 async function loadGraphifyMap(graphPath, repositoryRoot = process.cwd()) {
-  const raw = JSON.parse(await readFile3(graphPath, "utf8"));
+  const raw = JSON.parse(await readFile7(graphPath, "utf8"));
   const nodes = arrayRecord(raw.nodes ?? raw.entities);
   const edges = arrayRecord(raw.edges ?? raw.links ?? raw.relationships);
   const nodePaths = /* @__PURE__ */ new Map();
@@ -268,7 +925,7 @@ async function loadGraphifyMap(graphPath, repositoryRoot = process.cwd()) {
     nodePaths.set(id, path);
     const label = stringValue(node.label ?? node.name);
     if (label && label !== path && !path.endsWith(`/${label}`)) nodeLabels.set(id, label);
-    modules.push({ path, language: languageFor(path), imports: [] });
+    modules.push({ path, language: languageFor2(path), imports: [] });
   }
   const modulePaths = new Set(modules.map((module) => module.path));
   const importedEdges = [];
@@ -348,21 +1005,21 @@ function graphifyPath(node, repositoryRoot) {
   return candidate ? normalizeGraphPath(candidate, repositoryRoot) : null;
 }
 function normalizeGraphPath(path, repositoryRoot) {
-  const absolute = isAbsolute(path) ? resolve2(path) : resolve2(repositoryRoot, path);
-  const relativePath = relative2(resolve2(repositoryRoot), absolute).replace(/\\/g, "/");
+  const absolute = isAbsolute(path) ? resolve6(path) : resolve6(repositoryRoot, path);
+  const relativePath = relative4(resolve6(repositoryRoot), absolute).replace(/\\/g, "/");
   if (relativePath === "" || relativePath === ".." || relativePath.startsWith("../")) return null;
   return relativePath.replace(/^\.\//, "");
 }
 function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : null;
 }
-function languageFor(path) {
+function languageFor2(path) {
   if (/\.py$/.test(path)) return "py";
   return /\.tsx?$/.test(path) ? "ts" : "js";
 }
 
 // src/context/anchors.ts
-import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolve3, sep as sep2 } from "path";
+import { isAbsolute as isAbsolute2, relative as relative5, resolve as resolve7, sep as sep3 } from "path";
 var MAX_ANCHORS = 3;
 var MAX_ERROR_SEARCH_FILES = 2e3;
 var JS_FRAME = /\bat\s+(?:[^\s()]+\s+\()?([^\s()]+?):(\d+):\d+\)?/g;
@@ -370,7 +1027,7 @@ var PY_FRAME = /\bFile\s+"([^"]+)",\s+line\s+(\d+)/g;
 var PATH_TOKEN = /(?:^|[\s(`'"[])((?:\.{0,2}\/)?[\w@.-]+(?:\/[\w@.-]+)*\.[A-Za-z0-9]+)(?::(\d+))?/g;
 var QUOTED = /"([^"\n]{8,200})"|'([^'\n]{8,200})'|`([^`\n]{8,200})`/g;
 async function extractTaskAnchors(repositoryRoot, task, paths) {
-  const root = resolve3(repositoryRoot);
+  const root = resolve7(repositoryRoot);
   const found = [];
   const add = (raw, line, kind, at) => {
     const path = toIndexedPath(root, raw, paths);
@@ -398,9 +1055,9 @@ async function extractTaskAnchors(repositoryRoot, task, paths) {
   return anchors.slice(0, MAX_ANCHORS);
 }
 function toIndexedPath(root, raw, paths) {
-  const absolute = isAbsolute2(raw) ? raw : resolve3(root, raw);
-  const rel = relative3(root, absolute);
-  if (rel === "" || rel.startsWith(`..${sep2}`) || rel === ".." || isAbsolute2(rel)) return null;
+  const absolute = isAbsolute2(raw) ? raw : resolve7(root, raw);
+  const rel = relative5(root, absolute);
+  if (rel === "" || rel.startsWith(`..${sep3}`) || rel === ".." || isAbsolute2(rel)) return null;
   const normalized = rel.replace(/\\/g, "/");
   return paths.has(normalized) ? normalized : null;
 }
@@ -426,15 +1083,16 @@ async function errorAnchors(root, task, paths) {
 }
 
 // src/context/content-index.ts
-import { mkdir as mkdir2, readFile as readFile4 } from "fs/promises";
-import { dirname as dirname2, join as join2 } from "path";
+import { mkdir as mkdir4, readFile as readFile8 } from "fs/promises";
+import { dirname as dirname5, join as join7 } from "path";
 var PASSAGE_LINES = 40;
 var K1 = 1.2;
 var B = 0.75;
 var MIN_TERMS = 2;
 var MIN_SHARE = 0.5;
 var MIN_IDF_COVERAGE = 0.3;
-async function rankContent(repositoryRoot, manifest, terms, wantsTests, wantsDocs = false, wantsChangelog = false) {
+var CARD_WEIGHT = 0.5;
+async function rankContent(repositoryRoot, manifest, terms, wantsTests, wantsDocs = false, wantsChangelog = false, cards = /* @__PURE__ */ new Map()) {
   const none = { matches: [], idf: /* @__PURE__ */ new Map() };
   if (terms.length === 0) return none;
   const paths = Object.keys(manifest.entries).filter(
@@ -478,29 +1136,38 @@ async function rankContent(repositoryRoot, manifest, terms, wantsTests, wantsDoc
   }
   const documents = Object.entries(files);
   if (documents.length === 0) return none;
+  const cardWords = new Map(
+    documents.flatMap(([path]) => {
+      const text = cards.get(path);
+      return text ? [[path, new Set(splitWords(text))]] : [];
+    })
+  );
+  const has = (path, file, term) => (file.counts[term] ?? 0) > 0 || cardWords.get(path)?.has(term) === true;
   const averageLength = documents.reduce((sum, [, file]) => sum + file.length, 0) / documents.length;
   const idf = new Map(
     terms.map((term) => {
-      const df = documents.filter(([, file]) => (file.counts[term] ?? 0) > 0).length;
+      const df = documents.filter(([path, file]) => has(path, file, term)).length;
       return [term, Math.log(1 + (documents.length - df + 0.5) / (df + 0.5))];
     })
   );
   const totalIdf = [...idf.values()].reduce((sum, value) => sum + value, 0);
   const scored = documents.map(([path, file]) => {
     const fileName = new Set(splitWords(path.slice(path.lastIndexOf("/") + 1)));
+    const card = cardWords.get(path);
     let score = 0;
     let covered = 0;
     for (const term of terms) {
-      const tf = file.counts[term] ?? 0;
+      const inSource = file.counts[term] ?? 0;
+      const tf = inSource || (card?.has(term) ? CARD_WEIGHT : 0);
       if (tf === 0) continue;
-      covered += idf.get(term) ?? 0;
+      covered += (idf.get(term) ?? 0) * (inSource > 0 ? 1 : CARD_WEIGHT);
       const saturation = tf * (K1 + 1) / (tf + K1 * (1 - B + B * file.length / averageLength));
       score += (idf.get(term) ?? 0) * saturation * (fileName.has(term) ? 1.5 : 1);
     }
     const named = terms.filter((term) => fileName.has(term));
     const matched = Math.max(
       named.length,
-      ...file.passages.map(
+      ...[...file.passages, ...card ? [[...card]] : []].map(
         (words) => (/* @__PURE__ */ new Set([...named, ...terms.filter((term) => words.includes(term))])).size
       )
     );
@@ -520,11 +1187,11 @@ function idfCoverage(text, terms, idf) {
   return terms.reduce((sum, term) => sum + (words.has(term) ? idf.get(term) ?? 0 : 0), 0) / total;
 }
 function cachePath(repositoryRoot) {
-  return join2(repositoryRoot, ".codebuddy", "cache", "content-terms.json");
+  return join7(repositoryRoot, ".codebuddy", "cache", "content-terms.json");
 }
 async function loadCache(repositoryRoot) {
   try {
-    const parsed = JSON.parse(await readFile4(cachePath(repositoryRoot), "utf8"));
+    const parsed = JSON.parse(await readFile8(cachePath(repositoryRoot), "utf8"));
     if (parsed.version === 2 && parsed.files && typeof parsed.files === "object") return parsed;
   } catch {
   }
@@ -533,7 +1200,7 @@ async function loadCache(repositoryRoot) {
 async function saveCache(repositoryRoot, cache) {
   try {
     const path = cachePath(repositoryRoot);
-    await mkdir2(dirname2(path), { recursive: true });
+    await mkdir4(dirname5(path), { recursive: true });
     await writeAtomic(path, JSON.stringify(cache));
   } catch {
   }
@@ -547,22 +1214,25 @@ var MAX_EVIDENCE_BYTES = 512e3;
 async function readBoundedSource(repositoryRoot, path) {
   if (isCredentialPath(path)) return null;
   try {
-    const absolute = join3(repositoryRoot, path);
-    if ((await stat2(absolute)).size > MAX_EVIDENCE_BYTES) return null;
-    const source = await readFile5(absolute, "utf8");
+    const absolute = join8(repositoryRoot, path);
+    if ((await stat4(absolute)).size > MAX_EVIDENCE_BYTES) return null;
+    const source = await readFile9(absolute, "utf8");
     return source.includes("\0") ? null : source;
   } catch {
     return null;
   }
 }
 async function discoverTaskPaths(repositoryRoot, task, manifest, mapSource, options = {}) {
+  task = stripIssueTemplate(task);
   const anchors = await extractTaskAnchors(
     repositoryRoot,
     task,
     new Set(Object.keys(manifest.entries))
   );
-  if (anchors.length === 0)
-    return rankTaskFiles(repositoryRoot, task, manifest, mapSource, options);
+  if (anchors.length === 0) {
+    const ranked2 = await rankTaskFiles(repositoryRoot, task, manifest, mapSource, options);
+    return await withExpansion(repositoryRoot, task, ranked2, manifest, mapSource, options) ?? ranked2;
+  }
   const anchored = anchors.map((anchor) => anchor.path);
   const hits = anchors.flatMap(
     (anchor) => anchor.line === null ? [] : [
@@ -579,7 +1249,9 @@ async function discoverTaskPaths(repositoryRoot, task, manifest, mapSource, opti
   const explain = `retrieval: anchors (${anchors.map(
     (anchor) => `${anchor.kind} ${anchor.path}${anchor.line === null ? "" : `:${anchor.line}`}`
   ).join(", ")})`;
-  if (anchored.length >= TASK_FILES) return { paths: anchored, hits, explain: [explain] };
+  if (anchored.length >= TASK_FILES) {
+    return { paths: anchored, hits, explain: [explain], confidence: "high" };
+  }
   const ranked = await rankTaskFiles(repositoryRoot, task, manifest, mapSource, options);
   return {
     ...ranked.symbols ? { symbols: ranked.symbols } : {},
@@ -588,35 +1260,85 @@ async function discoverTaskPaths(repositoryRoot, task, manifest, mapSource, opti
       TASK_FILES
     ),
     hits: [...hits, ...ranked.hits.filter((hit) => !anchored.includes(hit.path))],
-    explain: [explain, ...ranked.explain]
+    explain: [explain, ...ranked.explain],
+    confidence: "high"
   };
 }
 async function withLlmSummaries(repositoryRoot, manifest) {
   const entries = Object.values(manifest.entries);
   try {
-    const { resolveLlmConfig } = await import("./config-GEZFLXK6.js");
-    const config = await resolveLlmConfig(repositoryRoot);
-    if (!config.enabled || !config.features.summaries) return entries;
-    const { loadLlmSummaries } = await import("./summaries-ML53R7EL.js");
+    if ((await readConfigFile(repositoryRoot)).llm?.enabled === false) return entries;
+    const { loadLlmSummaries, cardWords } = await import("./summaries-QXWFFDUZ.js");
     const summaries = await loadLlmSummaries(repositoryRoot, manifest);
     if (summaries.size === 0) return entries;
     return entries.map((entry) => {
       const summary = summaries.get(entry.path);
-      return summary ? { ...entry, llmText: `${summary.summary} ${Object.values(summary.symbols).join(" ")}` } : entry;
+      return summary ? {
+        ...entry,
+        llmText: `${summary.summary} ${Object.values(summary.symbols).join(" ")}`,
+        ...summary.symptoms ? { cardWords: cardWords(summary) } : {}
+      } : entry;
     });
   } catch {
     return entries;
   }
 }
+var EXPANSION_MS = { hook: 300, pack: 800 };
+async function withExpansion(repositoryRoot, task, ranked, manifest, mapSource, options) {
+  if (ranked.paths.length > 0 && ranked.confidence !== "low") return null;
+  if (identifierTokens(task).some((token) => CODE_IDENTIFIER.test(token))) return null;
+  const deadlineAt = options.expansionDeadlineAt ?? Date.now() + EXPANSION_MS.pack;
+  const { expandTask } = await import("./expand-KWYGNCKZ.js");
+  const expansion = await expandTask(repositoryRoot, task, deadlineAt - Date.now());
+  if (!expansion) return null;
+  const expanded = await rankTaskFiles(
+    repositoryRoot,
+    `${task} ${expansion.terms.join(" ")}`,
+    manifest,
+    mapSource,
+    options
+  );
+  const note = `expansion: task expanded with ${expansion.terms.length} code term(s) (${expansion.terms.join(", ")}; ${expansion.cached ? "cached" : "local model"})`;
+  if (expanded.paths.length === 0)
+    return { ...ranked, explain: [...ranked.explain, `${note}; still no match`] };
+  return { ...expanded, explain: [...ranked.explain, note, ...expanded.explain] };
+}
+var AGREEMENT = { topK: 5, chunkFloor: 0.8, cardFloor: 0.75 };
+function agreementVotes(path, signals, config = AGREEMENT) {
+  const names = [];
+  let scored = 0;
+  if (signals.zg.slice(0, config.topK).includes(path)) names.push("zg");
+  const within = (ranking, floor) => (ranking ?? []).slice(0, config.topK).some((match) => match.path === path && match.score >= floor);
+  if (within(signals.chunks, config.chunkFloor)) {
+    names.push("chunk");
+    scored++;
+  }
+  if (within(signals.cards, config.cardFloor)) {
+    names.push("card");
+    scored++;
+  }
+  if (signals.term) {
+    names.push("terms");
+    scored++;
+  }
+  return { votes: names.length, scored, names };
+}
+function agrees(vote) {
+  return vote.votes >= 2 && vote.scored >= 1;
+}
 async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options) {
   const wantsChangelog = asksForChangelog(task);
   const entries = (await withLlmSummaries(repositoryRoot, manifest)).filter(
     (entry) => wantsChangelog || !CHANGELOG_PATH.test(entry.path)
   );
   const wantsTests = /\b(tests?|spec)\b/i.test(task);
-  const identifiers = identifierTokens(task).filter((token) => CODE_IDENTIFIER.test(token));
+  const identifiers = identifierTokens(task).filter(
+    (token) => CODE_IDENTIFIER.test(token) && !ABBREVIATION.test(token)
+  );
   if (identifiers.length > 0) {
-    const exact = entries.filter((entry) => wantsTests || !TEST_PATH.test(entry.path)).map((entry) => ({
+    const exact = entries.filter(
+      (entry) => (wantsTests || !TEST_PATH.test(entry.path)) && countsAsSource(entry.path, task) && !EXCEPTION_MODULE.test(entry.path)
+    ).map((entry) => ({
       path: entry.path,
       named: new Set(
         (entry.symbolTable ?? []).flatMap(
@@ -637,6 +1359,7 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
       return {
         paths: expansion2.paths.slice(0, TASK_FILES),
         hits: [],
+        confidence: "high",
         explain: [
           `retrieval: exact-symbol routing (${identifiers.slice(0, 5).join(", ")})`,
           ...expansion2.explain ? [expansion2.explain] : []
@@ -653,7 +1376,8 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
     taskTerms(task),
     wantsTests,
     DOCS_TASK.test(task),
-    wantsChangelog
+    wantsChangelog,
+    new Map(entries.flatMap((entry) => entry.cardWords ? [[entry.path, entry.cardWords]] : []))
   );
   const keyword = content.length > 0 ? fuseRankings([summaryKeyword, content.map((match) => match.path)]) : summaryKeyword;
   const weakKeyword = scored.length - keyword.length;
@@ -664,7 +1388,7 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
     reason: "semantic retrieval off",
     stale: 0,
     changed: 0
-  } : await import("./zvec-XDZNZ2OL.js").then(
+  } : await import("./zvec-F73IBWO5.js").then(
     ({ zvecCandidates }) => zvecCandidates(
       repositoryRoot,
       task,
@@ -686,51 +1410,64 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
   let ranked = keyword;
   let hits = [];
   const explain = [];
+  const agreement = await agreementConfig(repositoryRoot);
+  const cardsOn = entries.some((entry) => entry.cardWords);
+  const dense = options.semantic === false && options.vectorDeadlineAt === void 0 ? null : await raceDeadline(
+    rankFileVectors(repositoryRoot, manifest, task, options.embed),
+    options.semantic === false ? options.vectorDeadlineAt : void 0
+  );
+  const chunks = dense?.chunks ?? null;
+  const cards = cardsOn ? dense?.cards ?? null : null;
+  const usable = (path) => (wantsTests || !TEST_PATH.test(path)) && (wantsChangelog || !CHANGELOG_PATH.test(path));
+  const zg = fuseRankings([semantic.paths, semantic.cardPaths ?? []]).filter(usable);
+  const votes = /* @__PURE__ */ new Map();
+  const denseAvailable = zg.length > 0 || chunks !== null || cards !== null;
   if (semantic.status !== "disabled" && semantic.paths.length === 0) {
     explain.push(`retrieval: keyword ranking only (${semantic.reason})`);
-  } else if (semantic.status !== "disabled") {
+  }
+  if (denseAvailable) {
     const terms = taskTerms(task);
     const vector = [];
-    const partial = [];
-    let uncorroborated = 0;
-    let belowFloor = 0;
-    const minScore = semantic.minScore ?? 0;
-    for (const path of semantic.paths) {
-      if (!wantsTests && TEST_PATH.test(path)) continue;
-      if (!wantsChangelog && CHANGELOG_PATH.test(path)) continue;
-      if (keyword.includes(path)) vector.push(path);
-      else if (await hasMatchedPassageEvidence(
-        repositoryRoot,
-        path,
-        semantic.hits,
-        terms,
-        manifest.entries[path]?.symbolTable ?? []
-      )) {
-        const source = await readBoundedSource(repositoryRoot, path) ?? "";
-        if (idfCoverage(`${path} ${source}`, terms, idf) < minScore) {
-          belowFloor++;
-          continue;
-        }
-        if (countTerms(source, terms) >= EVIDENCE_FLOOR.vectorTerms) vector.push(path);
-        else partial.push(path);
-        if (!evidence.has(path)) evidence.set(path, 0);
-      } else uncorroborated++;
+    let rejected = 0;
+    const top = (ranking) => (ranking ?? []).slice(0, agreement.topK).map((match) => match.path);
+    const candidates = [
+      .../* @__PURE__ */ new Set([
+        ...semantic.paths,
+        ...zg.slice(0, agreement.topK),
+        ...top(chunks),
+        ...top(cards)
+      ])
+    ].filter(usable);
+    for (const path of candidates) {
+      const termVote = await termEvidence(repositoryRoot, path, semantic, terms, idf, manifest);
+      const vote = agreementVotes(path, { zg, chunks, cards, term: termVote }, agreement);
+      votes.set(path, vote);
+      if (keyword.includes(path)) {
+        vector.push(path);
+        continue;
+      }
+      if (!countsAsSource(path, task) || !agrees(vote)) {
+        rejected++;
+        continue;
+      }
+      vector.push(path);
+      if (!evidence.has(path)) evidence.set(path, 0);
     }
     ranked = rankEvidenceCandidates(
       scored.map((entry) => entry.path),
       keyword,
       vector,
-      partial
+      []
     );
-    hits = semantic.hits.filter((hit) => vector.includes(hit.path) || partial.includes(hit.path));
+    hits = semantic.hits.filter((hit) => vector.includes(hit.path));
+    const sources = [
+      ...zg.length > 0 ? [semantic.reason] : [],
+      ...chunks ? ["file vectors"] : [],
+      ...cards ? ["intent-card vectors"] : []
+    ];
     explain.push(
-      `retrieval: keyword ranking fused with ${semantic.reason}` + (uncorroborated > 0 ? `; ${uncorroborated} uncorroborated vector file(s) dropped` : "")
+      `retrieval: keyword ranking fused with ${sources.join(", ")}; agreement rule (2 of zg/chunk/card/terms in top ${agreement.topK})` + (rejected > 0 ? `; ${rejected} dense candidate(s) without agreement dropped` : "")
     );
-    if (belowFloor > 0) {
-      explain.push(
-        `abstention: ${belowFloor} vector-only file(s) below zvec.minScore ${minScore} (task IDF coverage of current source) dropped`
-      );
-    }
   }
   let symbols;
   const reranked = await llmRerank({
@@ -752,21 +1489,21 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
   const wantsDocs = DOCS_TASK.test(task);
   if (!ranked.some((path) => countsAsSource(path, task))) {
     explain.push(
-      "abstention: no source file reached the evidence floor (" + (ranked.length > 0 ? "only docs/config did" : `best keyword score ${scored[0]?.score ?? 0} < ${EVIDENCE_FLOOR.keywordScore}`) + (commands.length > 0 ? "); only the named CLI command returned" : "); no task targets returned")
+      "abstention: no source file reached the evidence floor or the agreement rule (" + (ranked.length > 0 ? "only docs/config did" : `best keyword score ${scored[0]?.score ?? 0} < ${EVIDENCE_FLOOR.keywordScore}`) + (commands.length > 0 ? "); only the named CLI command returned" : "); no task targets returned")
     );
-    return { paths: commands, hits: [], explain };
+    return { paths: commands, hits: [], explain, confidence: commands.length > 0 ? "high" : "low" };
   }
   if (weakKeyword > 0) {
     explain.push(
       `abstention: ${weakKeyword} weak keyword candidate(s) below the evidence floor (score < ${EVIDENCE_FLOOR.keywordScore}) dropped`
     );
   }
-  const vectors = options.semantic === false || reranked ? null : await rankFilesByVector(repositoryRoot, manifest, task);
+  const vectors = reranked || !chunks ? null : cards ? fuseRankings([chunks, cards].map((ranking) => ranking.map((match) => match.path))) : chunks.map((match) => match.path);
   if (vectors && vectors.length > 0) {
     const doc = wantsDocs ? ranked.filter((path) => DOC_PATH.test(path)).slice(0, 1) : [];
-    ranked = [...doc, ...vectors.map((match) => match.path)].slice(0, TASK_FILES);
+    ranked = [...doc, ...vectors].slice(0, TASK_FILES);
     explain.push(
-      `retrieval: file vectors ordered the files (best ${vectors[0]?.score.toFixed(2)})`
+      `retrieval: ${cards ? "file and card" : "file"} vectors ordered the files (best chunk ${chunks?.[0]?.score.toFixed(2)})`
     );
   }
   const expansion = expandAlongImports(ranked, await mapSource, evidence, task);
@@ -780,18 +1517,82 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
       `abstention: ${paths.length - TASK_FILES} lower-ranked candidate(s) beyond the top ${TASK_FILES} dropped`
     );
   }
+  const returned = paths.slice(0, TASK_FILES);
+  const confidence = confidenceOf(returned, {
+    keyword,
+    strongKeyword: scored.filter((entry) => entry.score >= 2 * EVIDENCE_FLOOR.keywordScore).map((entry) => entry.path),
+    commands,
+    votes,
+    denseAvailable
+  });
+  if (confidence === "low") {
+    explain.push(
+      "abstention: low confidence (no returned file had two agreeing signals); no task targets returned"
+    );
+    return { paths: [], hits: [], explain, confidence };
+  }
   return {
-    paths: paths.slice(0, TASK_FILES),
+    paths: returned,
     hits,
     explain,
+    confidence,
     ...symbols && Object.keys(symbols).length > 0 ? { symbols } : {}
   };
 }
+function confidenceOf(paths, input) {
+  if (paths.some((path) => input.commands.includes(path))) return "high";
+  if (!input.denseAvailable) return "medium";
+  let best = 0;
+  for (const path of paths) {
+    const dense = input.votes.get(path)?.votes ?? 0;
+    const lexical = input.strongKeyword.includes(path) ? 2 : input.keyword.includes(path) ? 1 : 0;
+    best = Math.max(best, dense + lexical);
+  }
+  return best >= 3 ? "high" : best >= 2 ? "medium" : "low";
+}
+async function termEvidence(repositoryRoot, path, semantic, terms, idf, manifest) {
+  if (!await hasMatchedPassageEvidence(
+    repositoryRoot,
+    path,
+    semantic.hits,
+    terms,
+    manifest.entries[path]?.symbolTable ?? []
+  )) {
+    return false;
+  }
+  const source = await readBoundedSource(repositoryRoot, path) ?? "";
+  return idfCoverage(`${path} ${source}`, terms, idf) >= (semantic.minScore ?? DEFAULT_MIN_SCORE);
+}
+var DEFAULT_MIN_SCORE = 0.3;
+async function agreementConfig(repositoryRoot) {
+  try {
+    const configured = (await readConfigFile(repositoryRoot)).discovery?.agreement ?? {};
+    return {
+      topK: configured.topK ?? AGREEMENT.topK,
+      chunkFloor: configured.chunkFloor ?? AGREEMENT.chunkFloor,
+      cardFloor: configured.cardFloor ?? AGREEMENT.cardFloor
+    };
+  } catch {
+    return AGREEMENT;
+  }
+}
+async function raceDeadline(promise, deadlineAt) {
+  if (deadlineAt === void 0) return promise;
+  const ms = deadlineAt - Date.now();
+  if (ms <= 0) return null;
+  let timer;
+  return Promise.race([
+    promise,
+    new Promise((resolve8) => {
+      timer = setTimeout(() => resolve8(null), ms);
+    })
+  ]).finally(() => clearTimeout(timer));
+}
 var MIN_RERANK_MS = 200;
 async function llmRerank(input) {
   let config;
   try {
-    config = await (await import("./config-GEZFLXK6.js")).resolveLlmConfig(input.repositoryRoot);
+    config = await (await import("./config-TXQJCCVI.js")).resolveLlmConfig(input.repositoryRoot);
   } catch {
     return null;
   }
@@ -816,7 +1617,7 @@ async function llmRerank(input) {
     input.deadlineAt === void 0 ? config.timeoutMs : input.deadlineAt - Date.now()
   );
   if (deadlineMs < MIN_RERANK_MS) return skipped("no time left in the hook budget");
-  const { rerankCandidates } = await import("./rerank-IQAEWLQR.js");
+  const { rerankCandidates } = await import("./rerank-XXKWDI5Q.js");
   const result = await rerankCandidates(
     input.repositoryRoot,
     config,
@@ -888,7 +1689,7 @@ async function commandFiles(repositoryRoot, task, entries) {
 var COMMAND_DIR = /(^|\/)(cli|cmd|commands?)\//;
 async function packageBins(repositoryRoot) {
   try {
-    const manifest = JSON.parse(await readFile5(join3(repositoryRoot, "package.json"), "utf8"));
+    const manifest = JSON.parse(await readFile9(join8(repositoryRoot, "package.json"), "utf8"));
     if (typeof manifest.bin === "string" && typeof manifest.name === "string") {
       return [manifest.name.slice(manifest.name.lastIndexOf("/") + 1)];
     }
@@ -1058,6 +1859,17 @@ function foldPlural(word) {
   if (/(ss|sh|ch|x|z)es$/.test(word)) return word.slice(0, -2);
   return word.slice(0, -1);
 }
+var ISSUE_TEMPLATE = [
+  /_No response_/gi,
+  /\(Please specify[^)]*\)/gi,
+  /-\s*\[[ xX]\]\s*[\w.+-]+/g,
+  /\d+\.\s*(?:Go to|Click on|Scroll down to)\s*'\.+'|\bSee error\b/gi,
+  /#{1,6}\s*[\w-]+ Version\b(?:\s*v?\d+(?:\.\d+)+[\w.-]*,?)*/gi,
+  /#{1,6}\s*(?:Description|Summary|URL to code causing the issue|MCVE|Minimal reproducible example|Steps to reproduce|Expected behaviou?r|Actual behaviou?r|Screenshots|Logs|Environment|Platform|Additional context)\b/gi
+];
+function stripIssueTemplate(task) {
+  return ISSUE_TEMPLATE.reduce((text, pattern) => text.replace(pattern, " "), task);
+}
 function taskTerms(task) {
   return [
     ...new Set(
@@ -1070,6 +1882,8 @@ function countTerms(text, terms) {
   const words = new Set(splitWords(text));
   return terms.filter((term) => words.has(term)).length;
 }
+var ABBREVIATION = /^[a-z](?:\.[a-z])+$/i;
+var EXCEPTION_MODULE = /(^|\/)(exceptions?|errors?)(\/|\.[a-z]+$)/i;
 var CODE_IDENTIFIER = /[a-z0-9][A-Z]|[_$.]/;
 function identifierTokens(task) {
   const tokens = task.match(/[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*/g) ?? [];
@@ -1083,24 +1897,24 @@ async function loadProjectArchitectureMap(repositoryRoot, manifestSource) {
   const builtIn = (await loadArchitectureMap(repositoryRoot, manifest)).map;
   if (config.graphify?.enabled && await graphifyGraphExists(repositoryRoot, config.graphify.graphPath)) {
     try {
-      const graphPath = join3(
+      const graphPath = join8(
         repositoryRoot,
         config.graphify.graphPath ?? "graphify-out/graph.json"
       );
-      const [graph, graphFile, sourceHashes] = await Promise.all([
+      const [graph, graphFile, sourceHashes2] = await Promise.all([
         loadGraphifyMap(graphPath, repositoryRoot),
-        stat2(graphPath),
+        stat4(graphPath),
         readGraphSourceSnapshot(graphPath)
       ]);
       const livePaths = new Set(
         (await Promise.all(
           graph.modules.map(async (module) => {
             try {
-              const absolute = await realpath(join3(repositoryRoot, module.path));
-              const inside = relative4(await realpath(repositoryRoot), absolute);
+              const absolute = await realpath(join8(repositoryRoot, module.path));
+              const inside = relative6(await realpath(repositoryRoot), absolute);
               if (inside.startsWith("..") || isAbsolute3(inside)) return null;
-              const source = await stat2(absolute);
-              const fresh = sourceHashes === null ? source.mtimeMs <= graphFile.mtimeMs : sourceHashes[module.path] !== void 0 && sourceHashes[module.path] === manifest.entries[module.path]?.hash;
+              const source = await stat4(absolute);
+              const fresh = sourceHashes2 === null ? source.mtimeMs <= graphFile.mtimeMs : sourceHashes2[module.path] !== void 0 && sourceHashes2[module.path] === manifest.entries[module.path]?.hash;
               return source.isFile() && fresh ? module.path : null;
             } catch {
               return null;
@@ -1165,7 +1979,9 @@ async function refreshFileVectors(repositoryRoot, manifest, deadlineAt, embed =
     if (cached && cached.hash === manifest.entries[path]?.hash) files[path] = cached;
     else todo.push(path);
   }
+  const cards = await currentCardTexts(repositoryRoot, manifest);
   let embedded = 0;
+  let embeddedCards = 0;
   let lastSave = Date.now();
   for (const path of todo) {
     if (Date.now() >= deadlineAt) break;
@@ -1185,13 +2001,52 @@ async function refreshFileVectors(repositoryRoot, manifest, deadlineAt, embed =
       lastSave = Date.now();
     }
   }
+  const stale = Object.keys(files).filter((path) => {
+    const text = cards.get(path);
+    return text !== void 0 && files[path]?.cardHash !== textHash(text);
+  });
+  for (let start = 0; start < stale.length && Date.now() < deadlineAt; start += BATCH) {
+    const batch = stale.slice(start, start + BATCH);
+    const vectors = await embed(batch.map((path) => cards.get(path)));
+    batch.forEach((path, index) => {
+      const file = files[path];
+      const vector = vectors[index];
+      if (!file || !vector) return;
+      files[path] = {
+        ...file,
+        card: encode(vector),
+        cardHash: textHash(cards.get(path))
+      };
+      embeddedCards += 1;
+    });
+  }
+  for (const [path, file] of Object.entries(files)) {
+    if (file.card && !cards.has(path)) files[path] = { hash: file.hash, vectors: file.vectors };
+  }
   await saveStore(repositoryRoot, { version: 1, model: MODEL, files });
   return {
     embedded,
     files: Object.keys(files).length,
-    pending: eligible.length - Object.keys(files).length
+    pending: eligible.length - Object.keys(files).length,
+    ...embeddedCards > 0 ? { cards: embeddedCards } : {}
   };
 }
+async function currentCardTexts(repositoryRoot, manifest) {
+  try {
+    const { cardText, loadLlmSummaries } = await import("./summaries-QXWFFDUZ.js");
+    const texts = /* @__PURE__ */ new Map();
+    for (const [path, card] of await loadLlmSummaries(repositoryRoot, manifest)) {
+      if (card.symptoms) texts.set(path, `${path}
+${cardText(card)}`);
+    }
+    return texts;
+  } catch {
+    return /* @__PURE__ */ new Map();
+  }
+}
+function textHash(text) {
+  return createHash3("sha256").update(text).digest("hex").slice(0, 16);
+}
 async function syncFileVectors(repositoryRoot, budgetMs) {
   const started = Date.now();
   try {
@@ -1202,6 +2057,9 @@ async function syncFileVectors(repositoryRoot, budgetMs) {
   }
 }
 async function rankFilesByVector(repositoryRoot, manifest, task, embed = localEmbed) {
+  return (await rankFileVectors(repositoryRoot, manifest, task, embed))?.chunks ?? null;
+}
+async function rankFileVectors(repositoryRoot, manifest, task, embed = localEmbed) {
   if (process.env.CODEBUDDY_SEMANTIC === "0") return null;
   const store = await loadStore(repositoryRoot);
   const current = eligiblePaths(manifest).filter(
@@ -1216,10 +2074,16 @@ async function rankFilesByVector(repositoryRoot, manifest, task, embed = localEm
   } catch {
     return null;
   }
-  return current.map((path) => ({
+  const order = (left, right) => right.score - left.score || left.path.localeCompare(right.path);
+  const chunks = current.map((path) => ({
     path,
     score: Math.max(...(store.files[path]?.vectors ?? []).map((v) => dot(decode(v), query)))
-  })).sort((left, right) => right.score - left.score || left.path.localeCompare(right.path));
+  })).sort(order);
+  const cards = current.flatMap((path) => {
+    const card = store.files[path]?.card;
+    return card ? [{ path, score: dot(decode(card), query) }] : [];
+  }).sort(order);
+  return { chunks, cards: cards.length > 0 ? cards : null };
 }
 function eligiblePaths(manifest) {
   return Object.keys(manifest.entries).filter(
@@ -1251,11 +2115,11 @@ function dot(left, right) {
   return sum;
 }
 function storePath(repositoryRoot) {
-  return join4(repositoryRoot, ".codebuddy", "cache", "file-vectors.json");
+  return join9(repositoryRoot, ".codebuddy", "cache", "file-vectors.json");
 }
 async function loadStore(repositoryRoot) {
   try {
-    const parsed = JSON.parse(await readFile6(storePath(repositoryRoot), "utf8"));
+    const parsed = JSON.parse(await readFile10(storePath(repositoryRoot), "utf8"));
     if (parsed.version === 1 && parsed.model === MODEL && parsed.files) return parsed;
   } catch {
   }
@@ -1263,19 +2127,30 @@ async function loadStore(repositoryRoot) {
 }
 async function saveStore(repositoryRoot, store) {
   const path = storePath(repositoryRoot);
-  await mkdir3(dirname3(path), { recursive: true });
+  await mkdir5(dirname6(path), { recursive: true });
   await writeAtomic(path, JSON.stringify(store));
 }
 
 export {
+  buildArchitectureMap,
+  queryMap,
+  neighbours,
+  indexRepository,
+  loadFreshIndex,
+  hashContent,
   setupGraphify,
   generateGraphifyGraph,
   loadGraphifyMap,
+  refreshFileVectors,
   syncFileVectors,
+  rankFilesByVector,
+  rankFileVectors,
   TASK_PATH_LIMIT,
   readBoundedSource,
   discoverTaskPaths,
+  EXPANSION_MS,
   TEST_PATH,
+  CHANGELOG_PATH,
   asksForChangelog,
   NON_SOURCE_PATH,
   taskTerms,
@@ -1284,4 +2159,4 @@ export {
   namedSegments,
   loadProjectArchitectureMap
 };
-//# sourceMappingURL=chunk-TLWGZVPC.js.map
+//# sourceMappingURL=chunk-UR3DF74I.js.map