@orquentra/codebuddy 2.9.0 → 2.14.0

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

@@ -1,7 +1,8 @@
 import {
-  loadArchitectureMap,
-  loadFreshIndex
-} from "./chunk-ITQO632W.js";
+  extractPythonImports,
+  extractSymbolTable,
+  supportsSymbols
+} from "./chunk-Y7D7PUBE.js";
 import {
   isCredentialPath
 } from "./chunk-AL6VBTNA.js";
@@ -12,26 +13,681 @@ import {
   readConfigFile
 } from "./chunk-KNR2P2UY.js";
 import {
+  assertNoSymlinkBetween,
   writeAtomic
 } from "./chunk-CG5B3LYG.js";
 
+// src/map/indexer.ts
+import { readdir, readFile, stat } from "fs/promises";
+import { dirname, extname, join, relative, resolve } 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 = resolve(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 readFile(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 = resolve(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 readFile(join(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 = join(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, resolve(root, dirname(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/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 as readFile2 } from "fs/promises";
+import { dirname as dirname2, join as join2, resolve as resolve2 } 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 = resolve2(repositoryRoot);
+    this.cacheDirectory = join2(this.repositoryRoot, ".codebuddy", "cache");
+    this.manifestPath = join2(this.cacheDirectory, "index.json");
+  }
+  /** Read the manifest, or an empty one if absent/corrupt/version-mismatched. */
+  async read() {
+    try {
+      const raw = await readFile2(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, dirname2(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/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/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 +697,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 +790,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 +814,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 +831,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 +854,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}`);
@@ -212,16 +868,16 @@ function arrayLength(value) {
 }
 
 // src/context/file-vectors.ts
-import { mkdir as mkdir3, readFile as readFile6 } from "fs/promises";
-import { dirname as dirname3, join as join4 } from "path";
+import { mkdir as mkdir5, readFile as readFile10 } from "fs/promises";
+import { dirname as dirname6, join as join9 } 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";
+import { readFile as readFile9, realpath, stat as stat4 } from "fs/promises";
+import { isAbsolute as isAbsolute3, join as join8, relative as relative6 } 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 +911,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 +924,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 +1004,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 +1026,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 +1054,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,8 +1082,8 @@ 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;
@@ -520,11 +1176,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 +1189,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,15 +1203,16 @@ 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,
@@ -597,7 +1254,7 @@ async function withLlmSummaries(repositoryRoot, manifest) {
     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");
+    const { loadLlmSummaries } = await import("./summaries-32PHOB6L.js");
     const summaries = await loadLlmSummaries(repositoryRoot, manifest);
     if (summaries.size === 0) return entries;
     return entries.map((entry) => {
@@ -614,9 +1271,13 @@ async function rankTaskFiles(repositoryRoot, task, manifest, mapSource, options)
     (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(
@@ -664,7 +1325,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-24HLAFGN.js").then(
     ({ zvecCandidates }) => zvecCandidates(
       repositoryRoot,
       task,
@@ -888,7 +1549,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 +1719,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 +1742,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 +1757,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;
@@ -1251,11 +1925,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,11 +1937,17 @@ 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,
@@ -1284,4 +1964,4 @@ export {
   namedSegments,
   loadProjectArchitectureMap
 };
-//# sourceMappingURL=chunk-TLWGZVPC.js.map
+//# sourceMappingURL=chunk-YNSTIMCF.js.map