yandecode 0.1.1 → 0.2.0

package/dist/chunks/runtime-CVZMWIJO.js

@@ -0,0 +1,318 @@
+import { createRequire as __yandecodeCreateRequire } from 'node:module';
+const require = __yandecodeCreateRequire(import.meta.url);
+import {
+  splitSections
+} from "./chunk-KPDBXQ62.js";
+import {
+  fitRows
+} from "./chunk-OIAMKDTQ.js";
+import {
+  extractSymbols
+} from "./chunk-2S6B3DDQ.js";
+import {
+  external_exports,
+  openModuleDb,
+  queryInput,
+  resolveInput,
+  toFtsQuery
+} from "./chunk-Y2MIXROU.js";
+
+// packages/cli/src/modules/libdocs/runtime.ts
+import { join as join2 } from "node:path";
+
+// packages/cli/src/modules/libdocs/packages.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+var MAX_DOC_FILES = 400;
+var MAX_DECLARATION_BYTES = 4 * 1048576;
+function readJson(file) {
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function declaredDependencies(root) {
+  const out = /* @__PURE__ */ new Map();
+  const pkg = readJson(join(root, "package.json"));
+  for (const field of [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies"
+  ]) {
+    const deps = pkg?.[field];
+    if (typeof deps === "object" && deps !== null) {
+      for (const [name, range] of Object.entries(deps))
+        out.set(name, String(range));
+    }
+  }
+  const requirements = join(root, "requirements.txt");
+  if (existsSync(requirements)) {
+    for (const line of readFileSync(requirements, "utf8").split("\n")) {
+      const m = /^\s*([A-Za-z0-9_.-]+)\s*([<>=!~].*)?$/.exec(line.replace(/#.*/, ""));
+      if (m) out.set(m[1], m[2]?.trim() ?? "*");
+    }
+  }
+  return out;
+}
+function filesUnder(dir, pattern, depth = 0) {
+  if (!existsSync(dir) || depth > 5) return [];
+  return readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name)).flatMap((e) => {
+    const abs = join(dir, e.name);
+    if (e.isDirectory())
+      return e.name === "node_modules" ? [] : filesUnder(abs, pattern, depth + 1);
+    return pattern.test(e.name) ? [abs] : [];
+  });
+}
+function declarationFiles(dir, entry) {
+  const all = filesUnder(dir, /\.d\.(ts|mts|cts)$/);
+  const ordered = entry ? [join(dir, entry), ...all.filter((f) => f !== join(dir, entry))] : all;
+  const kept = [];
+  let bytes = 0;
+  for (const file of ordered) {
+    bytes += statSync(file).size;
+    if (bytes > MAX_DECLARATION_BYTES) break;
+    kept.push(file);
+  }
+  return kept;
+}
+function npmPackage(root, name, declared) {
+  const dir = join(root, "node_modules", ...name.split("/"));
+  const manifest = readJson(join(dir, "package.json"));
+  if (!manifest || typeof manifest.version !== "string") return null;
+  const readme = readdirSync(dir).filter((f) => /^readme(\.mdx?|\.markdown)?$/i.test(f));
+  const typesEntry = [manifest.types, manifest.typings, "index.d.ts"].find(
+    (t) => typeof t === "string" && existsSync(join(dir, t))
+  );
+  const docs = filesUnder(join(dir, "docs"), /\.mdx?$/i);
+  const files = [...readme.map((f) => join(dir, f)), ...docs, ...declarationFiles(dir, typesEntry)];
+  return {
+    name,
+    version: manifest.version,
+    ecosystem: "npm",
+    dir,
+    declared,
+    docFiles: files.slice(0, MAX_DOC_FILES)
+  };
+}
+function sitePackagesDirs(root) {
+  const dirs = [];
+  for (const venv of [".venv", "venv", "env"]) {
+    const lib = join(root, venv, "lib");
+    if (existsSync(lib)) {
+      for (const py of readdirSync(lib).filter((d) => d.startsWith("python")))
+        dirs.push(join(lib, py, "site-packages"));
+    }
+    const windows = join(root, venv, "Lib", "site-packages");
+    if (existsSync(windows)) dirs.push(windows);
+  }
+  return dirs.filter((d) => existsSync(d) && statSync(d).isDirectory());
+}
+function pythonPackage(root, name, declared) {
+  const normalized = name.toLowerCase().replace(/[-_.]+/g, "_");
+  for (const site of sitePackagesDirs(root)) {
+    const dist = readdirSync(site).find((d) => {
+      const m = /^(.+)-([^-]+)\.dist-info$/.exec(d);
+      return m !== null && m[1].toLowerCase().replace(/[-_.]+/g, "_") === normalized;
+    });
+    if (!dist) continue;
+    const version = /-([^-]+)\.dist-info$/.exec(dist)[1];
+    const metadata = join(site, dist, "METADATA");
+    return {
+      name,
+      version,
+      ecosystem: "python",
+      dir: join(site, dist),
+      declared,
+      docFiles: existsSync(metadata) ? [metadata] : []
+    };
+  }
+  return null;
+}
+function resolvePackage(root, name) {
+  const declared = declaredDependencies(root).get(name) ?? null;
+  return npmPackage(root, name, declared) ?? pythonPackage(root, name, declared);
+}
+
+// packages/cli/src/modules/libdocs/store.ts
+import { mkdirSync, readFileSync as readFileSync2 } from "node:fs";
+import { basename, dirname, relative } from "node:path";
+var MIGRATIONS = [
+  `
+  CREATE TABLE libs (key TEXT PRIMARY KEY, version TEXT NOT NULL, indexed_at TEXT NOT NULL, files TEXT NOT NULL);
+  CREATE TABLE sections (
+    id INTEGER PRIMARY KEY, lib TEXT NOT NULL, file TEXT NOT NULL, heading TEXT NOT NULL,
+    start_line INTEGER NOT NULL, end_line INTEGER NOT NULL, content TEXT NOT NULL
+  );
+  CREATE INDEX sections_lib ON sections (lib);
+  CREATE VIRTUAL TABLE sections_fts USING fts5 (content, heading, tokenize = 'porter unicode61');
+  `
+];
+async function declarationPieces(text, file) {
+  const lines = text.split("\n");
+  const symbols = (await extractSymbols(text, "typescript")).filter((s) => s.parent === null);
+  return symbols.map((s) => {
+    let start = s.startLine;
+    while (start > 1 && /^\s*(\/\*\*|\*)/.test(lines[start - 2] ?? "")) start--;
+    return {
+      heading: `${basename(file)} \u203A ${s.namePath}`,
+      startLine: start,
+      endLine: s.endLine,
+      content: lines.slice(start - 1, s.endLine).join("\n")
+    };
+  });
+}
+function metadataPieces(text) {
+  const blank = text.indexOf("\n\n");
+  const offset = blank < 0 ? 0 : text.slice(0, blank).split("\n").length + 1;
+  return splitSections(blank < 0 ? text : text.slice(blank + 2)).map((s) => ({
+    ...s,
+    startLine: s.startLine + offset,
+    endLine: s.endLine + offset
+  }));
+}
+var LibDocsStore = class _LibDocsStore {
+  constructor(db) {
+    this.db = db;
+  }
+  db;
+  static open(file) {
+    mkdirSync(dirname(file), { recursive: true });
+    return new _LibDocsStore(openModuleDb(file, MIGRATIONS));
+  }
+  close() {
+    this.db.close();
+  }
+  key(pkg) {
+    return `${pkg.ecosystem}:${pkg.name}`;
+  }
+  /** Indexes the package unless this exact version is already indexed; returns the file list. */
+  async ensure(pkg, root) {
+    const key = this.key(pkg);
+    const row = this.db.prepare("SELECT version, files FROM libs WHERE key = ?").get(key);
+    if (row?.version === pkg.version) return JSON.parse(row.files);
+    const pieces = await Promise.all(
+      pkg.docFiles.map(async (abs) => {
+        const text = readFileSync2(abs, "utf8");
+        const rel = relative(root, abs).split("\\").join("/");
+        const parts = /\.d\.[mc]?ts$/.test(abs) ? await declarationPieces(text, abs) : basename(abs) === "METADATA" ? metadataPieces(text) : splitSections(text);
+        return parts.map((p) => ({ ...p, file: rel }));
+      })
+    );
+    const files = pkg.docFiles.map((abs) => relative(pkg.dir, abs).split("\\").join("/"));
+    this.db.transaction(() => {
+      for (const { id } of this.db.prepare("SELECT id FROM sections WHERE lib = ?").all(key)) {
+        this.db.prepare("DELETE FROM sections_fts WHERE rowid = ?").run(id);
+      }
+      this.db.prepare("DELETE FROM sections WHERE lib = ?").run(key);
+      const insert = this.db.prepare(
+        "INSERT INTO sections (lib, file, heading, start_line, end_line, content) VALUES (?, ?, ?, ?, ?, ?)"
+      );
+      const fts = this.db.prepare(
+        "INSERT INTO sections_fts (rowid, content, heading) VALUES (?, ?, ?)"
+      );
+      for (const p of pieces.flat()) {
+        const id = insert.run(
+          key,
+          p.file,
+          p.heading,
+          p.startLine,
+          p.endLine,
+          p.content
+        ).lastInsertRowid;
+        fts.run(id, p.content, p.heading);
+      }
+      this.db.prepare(
+        "INSERT OR REPLACE INTO libs (key, version, indexed_at, files) VALUES (?, ?, ?, ?)"
+      ).run(key, pkg.version, (/* @__PURE__ */ new Date()).toISOString(), JSON.stringify(files));
+    })();
+    return files;
+  }
+  sectionCount(pkg) {
+    return this.db.prepare("SELECT COUNT(*) AS n FROM sections WHERE lib = ?").get(this.key(pkg)).n;
+  }
+  query(pkg, query, limit) {
+    const fts = toFtsQuery(query);
+    if (!fts) return [];
+    return this.db.prepare(
+      `SELECT s.file, s.heading, s.start_line, s.end_line, s.content
+           FROM sections_fts JOIN sections s ON s.id = sections_fts.rowid
+           WHERE sections_fts MATCH ? AND s.lib = ? ORDER BY bm25(sections_fts, 1.0, 2.0) LIMIT ?`
+    ).all(fts, this.key(pkg), limit).map((r) => ({
+      file: r.file,
+      heading: r.heading,
+      startLine: r.start_line,
+      endLine: r.end_line,
+      content: r.content
+    }));
+  }
+};
+
+// packages/cli/src/modules/libdocs/runtime.ts
+var stores = /* @__PURE__ */ new Map();
+function storeFor(ctx) {
+  let store = stores.get(ctx.root);
+  if (!store) {
+    store = LibDocsStore.open(join2(ctx.paths.yandecodeDir, "libdocs.db"));
+    stores.set(ctx.root, store);
+  }
+  return store;
+}
+function notFound(ctx, name) {
+  const declared = declaredDependencies(ctx.root);
+  const range = declared.get(name);
+  if (range !== void 0) {
+    return {
+      isError: true,
+      text: `${name} is declared in package.json (${range}) but not installed; install dependencies first (docs are read from the installed version).`
+    };
+  }
+  const needle = name.toLowerCase();
+  const close = [...declared.keys()].filter(
+    (d) => d.toLowerCase().includes(needle) || needle.includes(d.toLowerCase())
+  );
+  return {
+    isError: true,
+    text: `No installed package "${name}".${close.length > 0 ? ` Did you mean: ${close.slice(0, 5).join(", ")}?` : ""}`
+  };
+}
+var label = (pkg) => `${pkg.name}@${pkg.version} (${pkg.ecosystem}${pkg.declared ? `, declared ${pkg.declared}` : ""})`;
+async function libdocsResolve(raw, ctx) {
+  const { name } = external_exports.object(resolveInput).parse(raw);
+  const pkg = resolvePackage(ctx.root, name);
+  if (!pkg) return notFound(ctx, name);
+  const store = storeFor(ctx);
+  const files = await store.ensure(pkg, ctx.root);
+  const docs = files.length > 0 ? `${store.sectionCount(pkg)} sections from ${files.join(", ")}` : "no docs or type declarations shipped";
+  return { text: `${label(pkg)}
+${docs}
+Query with libdocs_query(name, query).` };
+}
+async function libdocsQuery(raw, ctx) {
+  const args = external_exports.object(queryInput).parse(raw);
+  const pkg = resolvePackage(ctx.root, args.name);
+  if (!pkg) return notFound(ctx, args.name);
+  const store = storeFor(ctx);
+  await store.ensure(pkg, ctx.root);
+  const sections = store.query(pkg, args.query, 6);
+  if (sections.length === 0)
+    return { text: `${label(pkg)}: nothing matches "${args.query}" in its shipped docs.` };
+  const blocks = sections.map(
+    (s) => `--- ${s.file}:${s.startLine}-${s.endLine} \xA7 ${s.heading}
+${s.content.trim()}`
+  );
+  return { text: fitRows(`${label(pkg)} \u2014 "${args.query}"`, blocks, args.max_chars ?? 5e3) };
+}
+var runtime = {
+  tools: { libdocs_resolve: libdocsResolve, libdocs_query: libdocsQuery },
+  dispose: () => {
+    for (const store of stores.values()) store.close();
+    stores.clear();
+    return Promise.resolve();
+  }
+};
+export {
+  runtime
+};
+//# sourceMappingURL=runtime-CVZMWIJO.js.map

package/dist/chunks/runtime-CVZMWIJO.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/modules/libdocs/runtime.ts", "../../src/modules/libdocs/packages.ts", "../../src/modules/libdocs/store.ts"],
+  "sourcesContent": ["import { join } from 'node:path';\nimport { z } from 'zod';\nimport type { ModuleContext, ModuleRuntime, ToolResult } from '@cli/modules/contract';\nimport { fitRows } from '@cli/shared/budget';\nimport { queryInput, resolveInput } from './definition';\nimport { declaredDependencies, resolvePackage, type InstalledPackage } from './packages';\nimport { LibDocsStore } from './store';\n\nconst stores = new Map<string, LibDocsStore>();\n\nfunction storeFor(ctx: ModuleContext): LibDocsStore {\n  let store = stores.get(ctx.root);\n  if (!store) {\n    store = LibDocsStore.open(join(ctx.paths.yandecodeDir, 'libdocs.db'));\n    stores.set(ctx.root, store);\n  }\n  return store;\n}\n\nfunction notFound(ctx: ModuleContext, name: string): ToolResult {\n  const declared = declaredDependencies(ctx.root);\n  const range = declared.get(name);\n  if (range !== undefined) {\n    return {\n      isError: true,\n      text: `${name} is declared in package.json (${range}) but not installed; install dependencies first (docs are read from the installed version).`,\n    };\n  }\n  const needle = name.toLowerCase();\n  const close = [...declared.keys()].filter(\n    (d) => d.toLowerCase().includes(needle) || needle.includes(d.toLowerCase()),\n  );\n  return {\n    isError: true,\n    text: `No installed package \"${name}\".${close.length > 0 ? ` Did you mean: ${close.slice(0, 5).join(', ')}?` : ''}`,\n  };\n}\n\nconst label = (pkg: InstalledPackage): string =>\n  `${pkg.name}@${pkg.version} (${pkg.ecosystem}${pkg.declared ? `, declared ${pkg.declared}` : ''})`;\n\nasync function libdocsResolve(\n  raw: Record<string, unknown>,\n  ctx: ModuleContext,\n): Promise<ToolResult> {\n  const { name } = z.object(resolveInput).parse(raw);\n  const pkg = resolvePackage(ctx.root, name);\n  if (!pkg) return notFound(ctx, name);\n  const store = storeFor(ctx);\n  const files = await store.ensure(pkg, ctx.root);\n  const docs =\n    files.length > 0\n      ? `${store.sectionCount(pkg)} sections from ${files.join(', ')}`\n      : 'no docs or type declarations shipped';\n  return { text: `${label(pkg)}\\n${docs}\\nQuery with libdocs_query(name, query).` };\n}\n\nasync function libdocsQuery(raw: Record<string, unknown>, ctx: ModuleContext): Promise<ToolResult> {\n  const args = z.object(queryInput).parse(raw);\n  const pkg = resolvePackage(ctx.root, args.name);\n  if (!pkg) return notFound(ctx, args.name);\n  const store = storeFor(ctx);\n  await store.ensure(pkg, ctx.root);\n  const sections = store.query(pkg, args.query, 6);\n  if (sections.length === 0)\n    return { text: `${label(pkg)}: nothing matches \"${args.query}\" in its shipped docs.` };\n  const blocks = sections.map(\n    (s) => `--- ${s.file}:${s.startLine}-${s.endLine} \u00A7 ${s.heading}\\n${s.content.trim()}`,\n  );\n  return { text: fitRows(`${label(pkg)} \u2014 \"${args.query}\"`, blocks, args.max_chars ?? 5_000) };\n}\n\nexport const runtime: ModuleRuntime = {\n  tools: { libdocs_resolve: libdocsResolve, libdocs_query: libdocsQuery },\n  dispose: () => {\n    for (const store of stores.values()) store.close();\n    stores.clear();\n    return Promise.resolve();\n  },\n};\n", "import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface InstalledPackage {\n  name: string;\n  version: string;\n  ecosystem: 'npm' | 'python';\n  dir: string;\n  /** Range declared by the project (package.json / requirements.txt), if any. */\n  declared: string | null;\n  /** Absolute paths of the files worth indexing, most useful first. */\n  docFiles: string[];\n}\n\nconst MAX_DOC_FILES = 400;\n/** Declaration files beyond this total size are skipped (huge generated typings). */\nconst MAX_DECLARATION_BYTES = 4 * 1_048_576;\n\nfunction readJson(file: string): Record<string, unknown> | null {\n  try {\n    return JSON.parse(readFileSync(file, 'utf8')) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\n/** Dependencies the project declares, name \u2192 version range. */\nexport function declaredDependencies(root: string): Map<string, string> {\n  const out = new Map<string, string>();\n  const pkg = readJson(join(root, 'package.json'));\n  for (const field of [\n    'dependencies',\n    'devDependencies',\n    'peerDependencies',\n    'optionalDependencies',\n  ]) {\n    const deps = pkg?.[field];\n    if (typeof deps === 'object' && deps !== null) {\n      for (const [name, range] of Object.entries(deps as Record<string, unknown>))\n        out.set(name, String(range));\n    }\n  }\n  const requirements = join(root, 'requirements.txt');\n  if (existsSync(requirements)) {\n    for (const line of readFileSync(requirements, 'utf8').split('\\n')) {\n      const m = /^\\s*([A-Za-z0-9_.-]+)\\s*([<>=!~].*)?$/.exec(line.replace(/#.*/, ''));\n      if (m) out.set(m[1]!, m[2]?.trim() ?? '*');\n    }\n  }\n  return out;\n}\n\nfunction filesUnder(dir: string, pattern: RegExp, depth = 0): string[] {\n  if (!existsSync(dir) || depth > 5) return [];\n  return readdirSync(dir, { withFileTypes: true })\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .flatMap((e) => {\n      const abs = join(dir, e.name);\n      if (e.isDirectory())\n        return e.name === 'node_modules' ? [] : filesUnder(abs, pattern, depth + 1);\n      return pattern.test(e.name) ? [abs] : [];\n    });\n}\n\n/** The types entry first, then every other declaration file, within a size budget. */\nfunction declarationFiles(dir: string, entry: string | undefined): string[] {\n  const all = filesUnder(dir, /\\.d\\.(ts|mts|cts)$/);\n  const ordered = entry ? [join(dir, entry), ...all.filter((f) => f !== join(dir, entry))] : all;\n  const kept: string[] = [];\n  let bytes = 0;\n  for (const file of ordered) {\n    bytes += statSync(file).size;\n    if (bytes > MAX_DECLARATION_BYTES) break;\n    kept.push(file);\n  }\n  return kept;\n}\n\nfunction npmPackage(root: string, name: string, declared: string | null): InstalledPackage | null {\n  const dir = join(root, 'node_modules', ...name.split('/'));\n  const manifest = readJson(join(dir, 'package.json'));\n  if (!manifest || typeof manifest.version !== 'string') return null;\n  const readme = readdirSync(dir).filter((f) => /^readme(\\.mdx?|\\.markdown)?$/i.test(f));\n  const typesEntry = [manifest.types, manifest.typings, 'index.d.ts'].find(\n    (t): t is string => typeof t === 'string' && existsSync(join(dir, t)),\n  );\n  const docs = filesUnder(join(dir, 'docs'), /\\.mdx?$/i);\n  const files = [...readme.map((f) => join(dir, f)), ...docs, ...declarationFiles(dir, typesEntry)];\n  return {\n    name,\n    version: manifest.version,\n    ecosystem: 'npm',\n    dir,\n    declared,\n    docFiles: files.slice(0, MAX_DOC_FILES),\n  };\n}\n\nfunction sitePackagesDirs(root: string): string[] {\n  const dirs: string[] = [];\n  for (const venv of ['.venv', 'venv', 'env']) {\n    const lib = join(root, venv, 'lib');\n    if (existsSync(lib)) {\n      for (const py of readdirSync(lib).filter((d) => d.startsWith('python')))\n        dirs.push(join(lib, py, 'site-packages'));\n    }\n    const windows = join(root, venv, 'Lib', 'site-packages');\n    if (existsSync(windows)) dirs.push(windows);\n  }\n  return dirs.filter((d) => existsSync(d) && statSync(d).isDirectory());\n}\n\nfunction pythonPackage(\n  root: string,\n  name: string,\n  declared: string | null,\n): InstalledPackage | null {\n  const normalized = name.toLowerCase().replace(/[-_.]+/g, '_');\n  for (const site of sitePackagesDirs(root)) {\n    const dist = readdirSync(site).find((d) => {\n      const m = /^(.+)-([^-]+)\\.dist-info$/.exec(d);\n      return m !== null && m[1]!.toLowerCase().replace(/[-_.]+/g, '_') === normalized;\n    });\n    if (!dist) continue;\n    const version = /-([^-]+)\\.dist-info$/.exec(dist)![1]!;\n    const metadata = join(site, dist, 'METADATA');\n    return {\n      name,\n      version,\n      ecosystem: 'python',\n      dir: join(site, dist),\n      declared,\n      docFiles: existsSync(metadata) ? [metadata] : [],\n    };\n  }\n  return null;\n}\n\n/** The installed package for `name` (npm first, then the project's Python virtualenv). */\nexport function resolvePackage(root: string, name: string): InstalledPackage | null {\n  const declared = declaredDependencies(root).get(name) ?? null;\n  return npmPackage(root, name, declared) ?? pythonPackage(root, name, declared);\n}\n", "import { mkdirSync, readFileSync } from 'node:fs';\nimport { basename, dirname, relative } from 'node:path';\nimport { openModuleDb, toFtsQuery, type Database } from '@yandecode/core';\nimport { extractSymbols } from '@yandecode/retrieval';\nimport { splitSections } from '@cli/shared/markdown';\nimport type { InstalledPackage } from './packages';\n\nconst MIGRATIONS = [\n  `\n  CREATE TABLE libs (key TEXT PRIMARY KEY, version TEXT NOT NULL, indexed_at TEXT NOT NULL, files TEXT NOT NULL);\n  CREATE TABLE sections (\n    id INTEGER PRIMARY KEY, lib TEXT NOT NULL, file TEXT NOT NULL, heading TEXT NOT NULL,\n    start_line INTEGER NOT NULL, end_line INTEGER NOT NULL, content TEXT NOT NULL\n  );\n  CREATE INDEX sections_lib ON sections (lib);\n  CREATE VIRTUAL TABLE sections_fts USING fts5 (content, heading, tokenize = 'porter unicode61');\n  `,\n];\n\nexport interface DocSection {\n  file: string;\n  heading: string;\n  startLine: number;\n  endLine: number;\n  content: string;\n}\n\ninterface Piece {\n  heading: string;\n  startLine: number;\n  endLine: number;\n  content: string;\n}\n\n/** Top-level declarations of a .d.ts file, each with the doc comment right above it. */\nasync function declarationPieces(text: string, file: string): Promise<Piece[]> {\n  const lines = text.split('\\n');\n  const symbols = (await extractSymbols(text, 'typescript')).filter((s) => s.parent === null);\n  return symbols.map((s) => {\n    let start = s.startLine;\n    while (start > 1 && /^\\s*(\\/\\*\\*|\\*)/.test(lines[start - 2] ?? '')) start--;\n    return {\n      heading: `${basename(file)} \u203A ${s.namePath}`,\n      startLine: start,\n      endLine: s.endLine,\n      content: lines.slice(start - 1, s.endLine).join('\\n'),\n    };\n  });\n}\n\n/** METADATA = RFC 822 headers, a blank line, then the long description (usually the README). */\nfunction metadataPieces(text: string): Piece[] {\n  const blank = text.indexOf('\\n\\n');\n  const offset = blank < 0 ? 0 : text.slice(0, blank).split('\\n').length + 1;\n  return splitSections(blank < 0 ? text : text.slice(blank + 2)).map((s) => ({\n    ...s,\n    startLine: s.startLine + offset,\n    endLine: s.endLine + offset,\n  }));\n}\n\n/** Installed-version documentation per library, reindexed whenever the version changes. */\nexport class LibDocsStore {\n  private constructor(private readonly db: Database) {}\n\n  static open(file: string): LibDocsStore {\n    mkdirSync(dirname(file), { recursive: true });\n    return new LibDocsStore(openModuleDb(file, MIGRATIONS));\n  }\n\n  close(): void {\n    this.db.close();\n  }\n\n  private key(pkg: InstalledPackage): string {\n    return `${pkg.ecosystem}:${pkg.name}`;\n  }\n\n  /** Indexes the package unless this exact version is already indexed; returns the file list. */\n  async ensure(pkg: InstalledPackage, root: string): Promise<string[]> {\n    const key = this.key(pkg);\n    const row = this.db.prepare('SELECT version, files FROM libs WHERE key = ?').get(key) as\n      { version: string; files: string } | undefined;\n    if (row?.version === pkg.version) return JSON.parse(row.files) as string[];\n    const pieces = await Promise.all(\n      pkg.docFiles.map(async (abs) => {\n        const text = readFileSync(abs, 'utf8');\n        const rel = relative(root, abs).split('\\\\').join('/');\n        const parts = /\\.d\\.[mc]?ts$/.test(abs)\n          ? await declarationPieces(text, abs)\n          : basename(abs) === 'METADATA'\n            ? metadataPieces(text)\n            : splitSections(text);\n        return parts.map((p) => ({ ...p, file: rel }));\n      }),\n    );\n    const files = pkg.docFiles.map((abs) => relative(pkg.dir, abs).split('\\\\').join('/'));\n    this.db.transaction(() => {\n      for (const { id } of this.db.prepare('SELECT id FROM sections WHERE lib = ?').all(key) as {\n        id: number;\n      }[]) {\n        this.db.prepare('DELETE FROM sections_fts WHERE rowid = ?').run(id);\n      }\n      this.db.prepare('DELETE FROM sections WHERE lib = ?').run(key);\n      const insert = this.db.prepare(\n        'INSERT INTO sections (lib, file, heading, start_line, end_line, content) VALUES (?, ?, ?, ?, ?, ?)',\n      );\n      const fts = this.db.prepare(\n        'INSERT INTO sections_fts (rowid, content, heading) VALUES (?, ?, ?)',\n      );\n      for (const p of pieces.flat()) {\n        const id = insert.run(\n          key,\n          p.file,\n          p.heading,\n          p.startLine,\n          p.endLine,\n          p.content,\n        ).lastInsertRowid;\n        fts.run(id, p.content, p.heading);\n      }\n      this.db\n        .prepare(\n          'INSERT OR REPLACE INTO libs (key, version, indexed_at, files) VALUES (?, ?, ?, ?)',\n        )\n        .run(key, pkg.version, new Date().toISOString(), JSON.stringify(files));\n    })();\n    return files;\n  }\n\n  sectionCount(pkg: InstalledPackage): number {\n    return (\n      this.db.prepare('SELECT COUNT(*) AS n FROM sections WHERE lib = ?').get(this.key(pkg)) as {\n        n: number;\n      }\n    ).n;\n  }\n\n  query(pkg: InstalledPackage, query: string, limit: number): DocSection[] {\n    const fts = toFtsQuery(query);\n    if (!fts) return [];\n    return (\n      this.db\n        .prepare(\n          `SELECT s.file, s.heading, s.start_line, s.end_line, s.content\n           FROM sections_fts JOIN sections s ON s.id = sections_fts.rowid\n           WHERE sections_fts MATCH ? AND s.lib = ? ORDER BY bm25(sections_fts, 1.0, 2.0) LIMIT ?`,\n        )\n        .all(fts, this.key(pkg), limit) as {\n        file: string;\n        heading: string;\n        start_line: number;\n        end_line: number;\n        content: string;\n      }[]\n    ).map((r) => ({\n      file: r.file,\n      heading: r.heading,\n      startLine: r.start_line,\n      endLine: r.end_line,\n      content: r.content,\n    }));\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["join", "readFileSync", "readFileSync", "join"]
+}

package/dist/chunks/runtime-DBNXBOAL.js

@@ -0,0 +1,295 @@
+import { createRequire as __yandecodeCreateRequire } from 'node:module';
+const require = __yandecodeCreateRequire(import.meta.url);
+import {
+  moduleContext,
+  requireWorkspace
+} from "./chunk-QCQC73WX.js";
+import {
+  codeModule,
+  definitionInput,
+  referencesInput,
+  repoMapInput,
+  searchInput,
+  symbolsInput
+} from "./chunk-7L6DD2VD.js";
+import {
+  fitRows
+} from "./chunk-OIAMKDTQ.js";
+import {
+  CodeIndex
+} from "./chunk-2S6B3DDQ.js";
+import {
+  external_exports
+} from "./chunk-Y2MIXROU.js";
+
+// packages/cli/src/modules/code/runtime.ts
+import { join as join3 } from "node:path";
+
+// packages/cli/src/shared/once.ts
+import { mkdirSync, openSync, closeSync } from "node:fs";
+import { join } from "node:path";
+function firstTimeInSession(yandecodeDir, sessionId, kind) {
+  const dir = join(yandecodeDir, "hints");
+  mkdirSync(dir, { recursive: true });
+  const safe = `${sessionId}.${kind}`.replace(/[^\w.-]/g, "_");
+  try {
+    closeSync(openSync(join(dir, safe), "wx"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// packages/cli/src/modules/code/nudge.ts
+import { statSync } from "node:fs";
+import { extname, isAbsolute, join as join2 } from "node:path";
+var CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".py",
+  ".rs",
+  ".go",
+  ".java",
+  ".kt",
+  ".c",
+  ".h",
+  ".cc",
+  ".cpp",
+  ".hpp",
+  ".cs",
+  ".rb",
+  ".php",
+  ".swift",
+  ".scala"
+]);
+var LARGE_FILE_BYTES = 12e3;
+var SEARCH = {
+  kind: "search",
+  text: "yandecode: to find where code is defined or handled, `code_search(query)` returns path:line rows with signatures (identifiers, `Class/method`, file fragments or plain words), and `code_references(name)` lists usages \u2014 cheaper than grep/find over source files."
+};
+var READ = {
+  kind: "read",
+  text: "yandecode: `code_symbols(path)` lists a file\u2019s functions and types with line ranges, and `code_definition(name)` returns just one of them \u2014 read or cat whole source files only when you will edit most of them."
+};
+var isCode = (path) => CODE_EXTENSIONS.has(extname(path).toLowerCase());
+function segments(command) {
+  return command.replace(/'[^']*'|"(?:\\.|[^"\\])*"/g, "''").split(/&&|\|\||;|\|/).map((s) => s.trim());
+}
+function bashNudge(command) {
+  const parts = segments(command);
+  if (parts.some(
+    (s) => /^(grep|egrep|rg|ag|ack|git grep)\b/.test(s) || /^find\b.*-(name|path|iname)\b/.test(s)
+  )) {
+    return SEARCH;
+  }
+  const reads = /^(cat|head|tail|sed -n|nl|less|more)\b/;
+  if (parts.some((s) => reads.test(s)) && [...command.matchAll(/[\w./-]+\.\w+/g)].some((m) => isCode(m[0]))) {
+    return READ;
+  }
+  return null;
+}
+function readNudge(input, root) {
+  const path = input.file_path;
+  if (typeof path !== "string" || !isCode(path) || input.offset !== void 0 || input.limit !== void 0)
+    return null;
+  const size = statSync(isAbsolute(path) ? path : join2(root, path), { throwIfNoEntry: false })?.size ?? 0;
+  return size > LARGE_FILE_BYTES ? READ : null;
+}
+function nudgeFor(tool, input, root) {
+  if (tool === "Grep" || tool === "Glob") return SEARCH;
+  if (tool === "Bash" && typeof input.command === "string") return bashNudge(input.command);
+  if (tool === "Read") return readNudge(input, root);
+  return null;
+}
+
+// packages/cli/src/modules/code/runtime.ts
+var SYNC_INTERVAL_MS = 1500;
+var open = /* @__PURE__ */ new Map();
+async function freshIndex(ctx) {
+  let entry = open.get(ctx.root);
+  if (!entry) {
+    entry = {
+      index: CodeIndex.open(join3(ctx.paths.yandecodeDir, "code.db"), ctx.root),
+      lastSync: 0
+    };
+    open.set(ctx.root, entry);
+  }
+  if (Date.now() - entry.lastSync > SYNC_INTERVAL_MS) {
+    await entry.index.sync();
+    entry.lastSync = Date.now();
+  }
+  return entry.index;
+}
+var text = (value) => ({ text: value });
+function symbolRow(s) {
+  return `${s.path}:${s.startLine}-${s.endLine} ${s.kind} ${s.namePath} \u2014 ${s.signature}`;
+}
+function textRow(h) {
+  return `${h.path}:${h.startLine}-${h.endLine}${h.symbol ? ` [${h.symbol}]` : ""} ${h.snippet}`;
+}
+function routeQuery(query) {
+  const q = query.trim();
+  if (/\s/.test(q)) return ["text"];
+  if (/\.[a-z0-9]{1,5}$/i.test(q) || q.includes("/") && q.includes(".")) return ["path"];
+  if (q.includes("/")) return ["symbol", "path"];
+  return ["symbol", "path", "text"];
+}
+function symbolSection(index, query, path, limit) {
+  const filter = path ? { path } : {};
+  const exact = index.findSymbols(query, { ...filter, limit });
+  return exact.length > 0 ? exact : index.findSymbols(query, { ...filter, substring: true, limit });
+}
+function gather(index, args, modes, auto) {
+  const limit = args.limit ?? 10;
+  const exact = modes.includes("symbol") ? symbolSection(index, args.query, args.path, limit) : [];
+  const echoed = modes.includes("symbol") ? [] : index.findSymbolsByTerms(args.query, { limit: 3 });
+  const pathLimit = exact.length > 0 ? Math.min(limit, 3) : limit;
+  const wantText = modes.includes("text") && (!auto || exact.length === 0);
+  return {
+    symbols: [...exact, ...echoed],
+    paths: modes.includes("path") ? index.searchPaths(args.query, pathLimit) : [],
+    textHits: wantText ? index.searchText(args.query, echoed.length > 0 ? Math.min(limit, 6) : limit) : []
+  };
+}
+function section(title, rows) {
+  return rows.length > 0 ? [title, ...rows.map((r) => `  ${r}`)] : [];
+}
+async function codeSearch(raw, ctx) {
+  const args = external_exports.object(searchInput).parse(raw);
+  const index = await freshIndex(ctx);
+  const auto = (args.mode ?? "auto") === "auto";
+  const modes = auto ? routeQuery(args.query) : [args.mode];
+  const found = gather(index, args, modes, auto);
+  const rows = [
+    ...section("symbols:", found.symbols.map(symbolRow)),
+    ...section("files:", found.paths),
+    ...section("text:", found.textHits.map(textRow))
+  ];
+  if (rows.length === 0) {
+    return text(
+      `No code matches "${args.query}" (strategies: ${modes.join(", ")}). Try other words, a file fragment or mode=text.`
+    );
+  }
+  return text(
+    fitRows(`code_search "${args.query}" (${modes.join("+")})`, rows, args.max_chars ?? 4e3)
+  );
+}
+async function codeSymbols(raw, ctx) {
+  const args = external_exports.object(symbolsInput).parse(raw);
+  const index = await freshIndex(ctx);
+  const path = args.path.replace(/^\.\//, "");
+  const outline = index.outline(path);
+  if (outline.length === 0) {
+    const similar = index.searchPaths(path, 3);
+    return text(
+      `No symbols indexed for ${path}.${similar.length > 0 ? ` Did you mean: ${similar.join(", ")}?` : ""}`
+    );
+  }
+  const rows = outline.map(
+    (s) => `${"  ".repeat(s.namePath.split("/").length - 1)}${s.startLine}-${s.endLine} ${s.kind} ${s.name} \u2014 ${s.signature}`
+  );
+  return text(fitRows(`${path} (${outline.length} symbols)`, rows, args.max_chars ?? 4e3));
+}
+async function codeDefinition(raw, ctx) {
+  const args = external_exports.object(definitionInput).parse(raw);
+  const index = await freshIndex(ctx);
+  const found = index.definition(args.name_path, args.path);
+  if (!found) {
+    const near = index.findSymbols(args.name_path.split("/").pop(), { substring: true, limit: 5 });
+    return text(
+      `Symbol "${args.name_path}" not found.${near.length > 0 ? ` Close matches: ${near.map((s) => s.namePath).join(", ")}` : ""}`
+    );
+  }
+  const others = index.findSymbols(args.name_path, { limit: 6 }).length - 1;
+  const ambiguity = others > 0 ? ` (${others} other symbol(s) share this name; pass path= to choose)` : "";
+  const header = `${found.path}:${found.startLine}-${found.endLine} ${found.kind} ${found.namePath}${ambiguity}`;
+  const numbered = found.body.split("\n").map((line, i) => `${found.startLine + i}	${line}`);
+  return text(fitRows(header, numbered, args.max_chars ?? 8e3));
+}
+async function codeReferences(raw, ctx) {
+  const args = external_exports.object(referencesInput).parse(raw);
+  const index = await freshIndex(ctx);
+  const refs = index.references(args.name_path, 200);
+  const definition = index.findSymbols(args.name_path, { limit: 1 })[0];
+  const rows = refs.map((r) => `${r.path}:${r.line} ${r.text}`);
+  const importers = definition ? index.importersOf(definition.path) : [];
+  if (definition && importers.length > 0) {
+    rows.push(`importers of ${definition.path}: ${importers.join(", ")}`);
+  }
+  if (rows.length === 0) return text(`No references to "${args.name_path}" found.`);
+  return text(
+    fitRows(
+      `references to ${args.name_path} (${refs.length} lines, lexical)`,
+      rows,
+      args.max_chars ?? 4e3
+    )
+  );
+}
+async function repoMap(raw, ctx) {
+  const args = external_exports.object(repoMapInput).parse(raw);
+  const index = await freshIndex(ctx);
+  const focus = args.focus?.replace(/^\.\//, "");
+  const map = index.repoMap({ maxChars: args.max_chars ?? 6e3, ...focus ? { focus } : {} });
+  return text(map.length > 0 ? map : `No indexed files${focus ? ` under ${focus}` : ""}.`);
+}
+function preToolUse(input, ctx) {
+  const nudge = nudgeFor(input.tool_name ?? "", input.tool_input ?? {}, ctx.root);
+  if (!nudge || !firstTimeInSession(ctx.paths.yandecodeDir, input.session_id ?? "unknown", nudge.kind)) {
+    return Promise.resolve({ kind: "none" });
+  }
+  ctx.log("nudge", { kind: nudge.kind, tool: input.tool_name });
+  return Promise.resolve({ kind: "context", text: nudge.text });
+}
+var runtime = {
+  hooks: { PreToolUse: preToolUse },
+  tools: {
+    code_search: codeSearch,
+    code_symbols: codeSymbols,
+    code_definition: codeDefinition,
+    code_references: codeReferences,
+    repo_map: repoMap
+  },
+  doctor: async (ctx) => {
+    const index = await freshIndex(ctx);
+    const stats = index.stats();
+    return [
+      {
+        name: "code index",
+        status: stats.files > 0 ? "ok" : "warn",
+        detail: `${stats.files} files, ${stats.symbols} symbols, ${stats.chunks} chunks`,
+        ...stats.files > 0 ? {} : { fix: "no source files found; check .gitignore" }
+      }
+    ];
+  },
+  dispose: () => {
+    for (const entry of open.values()) entry.index.close();
+    open.clear();
+    return Promise.resolve();
+  }
+};
+async function runIndexCommand(cwd) {
+  const ws = requireWorkspace(cwd);
+  const index = await freshIndex(moduleContext(ws, codeModule));
+  const report = await index.sync();
+  const stats = index.stats();
+  process.stdout.write(
+    `code index: ${stats.files} files, ${stats.symbols} symbols (+${report.added} ~${report.changed} -${report.removed}) in ${report.durationMs} ms
+`
+  );
+}
+async function runSearchCommand(cwd, query) {
+  const ws = requireWorkspace(cwd);
+  const result = await codeSearch({ query }, moduleContext(ws, codeModule));
+  process.stdout.write(`${result.text}
+`);
+}
+export {
+  runIndexCommand,
+  runSearchCommand,
+  runtime
+};
+//# sourceMappingURL=runtime-DBNXBOAL.js.map