@wrongstack/tools 0.7.5 → 0.7.7

package/dist/codebase-index/index.d.ts

@@ -0,0 +1,120 @@
+import { d as Symbol, F as FileMeta, e as SymbolKind, f as SymbolLang, c as SearchResult, b as IndexStats, R as Ref } from '../codebase-stats-tool-BLhQmPNc.js';
+export { a as FileSymbols, I as IndexResult, S as SCHEMA_VERSION, g as codebaseIndexTool, h as codebaseSearchTool, i as codebaseStatsTool } from '../codebase-stats-tool-BLhQmPNc.js';
+import '@wrongstack/core';
+
+/**
+ * SQLite storage layer for the codebase index.
+ *
+ * Uses `node:sqlite` (synchronous API — DatabaseSync class).
+ * Database file: {projectRoot}/.codebase-index/index.db
+ */
+
+declare class IndexStore {
+    private projectRoot;
+    private db;
+    constructor(projectRoot: string);
+    private initSchema;
+    insertSymbols(symbols: Symbol[], nextId: number): number;
+    deleteSymbolsForFile(file: string): void;
+    deleteFile(file: string): void;
+    upsertFile(meta: FileMeta): void;
+    getFileMeta(file: string): FileMeta | null;
+    getAllFileMetas(): FileMeta[];
+    search(query: string, filter?: {
+        kind?: SymbolKind;
+        lang?: SymbolLang;
+        file?: string;
+        lspKind?: number;
+    }): SearchResult[];
+    getAllIndexable(): Array<{
+        id: number;
+        text: string;
+    }>;
+    getStats(): IndexStats;
+    setLastIndexed(ts: number): void;
+    clearAll(): void;
+    /**
+     * Insert cross-references for a given source symbol id.
+     * Replaces any existing refs from the same source (idempotent on re-index).
+     */
+    insertRefs(fromId: number, refs: Ref[]): void;
+    /**
+     * Delete all refs whose source symbols are in a given file.
+     * Used when re-indexing a file to clear stale refs.
+     */
+    deleteRefsForFile(file: string): void;
+    /**
+     * Resolve `to_name` → `to_id` for all refs that have a name but no id.
+     * Call this after all symbols have been inserted to fill in cross-references.
+     */
+    resolveRefs(): number;
+    /**
+     * Find all references TO a given symbol (who calls / uses this symbol?).
+     */
+    findRefsTo(symbolId: number): Ref[];
+    /**
+     * Find all references FROM a given symbol (what does this symbol call/use?).
+     */
+    findRefsFrom(symbolId: number): Ref[];
+    private sizeBytes;
+    close(): void;
+}
+
+/**
+ * BM25 ranking implementation — no external dependencies.
+ *
+ * Algorithm: Okapi BM25 with standard parameters (k1=1.5, b=0.75).
+ */
+interface Bm25Doc {
+    id: number;
+    tokens: string[];
+    raw: string;
+    len: number;
+}
+/** Tokenise a string into lowercase word tokens. */
+declare function tokenise(text: string): string[];
+interface IndexableDoc {
+    id: number;
+    text: string;
+}
+/**
+ * Build indexable text for BM25 from a symbol's fields.
+ * The name is split into camelCase/SnakeCase words so that queries
+ * like "complex" match "complexOperation". The verbatim name is
+ * also included for exact-match queries.
+ */
+declare function buildIndexableText(name: string, signature: string, docComment: string): string;
+declare function buildBm25Index(docs: IndexableDoc[]): Bm25Index;
+declare class Bm25Index {
+    private documents;
+    private df;
+    private N;
+    private readonly safeAvgLen;
+    constructor(documents: Bm25Doc[], df: Record<string, number>, N: number, avgLen: number);
+    score(query: string, filter?: (id: number) => boolean): Array<{
+        id: number;
+        score: number;
+    }>;
+    getDoc(id: number): Bm25Doc | undefined;
+    extractSnippet(docId: number, queryTokens: string[], radius?: number): string;
+}
+
+/**
+ * LSP SymbolKind mapping utilities.
+ *
+ * LSP SymbolKind numbers are defined by vscode-languageserver-protocol.
+ * This module maps between LSP kind numbers and the internal SymbolKind taxonomy.
+ */
+
+/**
+ * Maps an LSP kind number to the corresponding internal SymbolKind.
+ * Returns null if the LSP kind has no equivalent in the internal taxonomy.
+ */
+declare function lspKindToInternalKind(k: number): SymbolKind | null;
+/**
+ * Maps an internal SymbolKind to the corresponding LSP kind number.
+ * Returns null if the internal kind has no equivalent LSP kind.
+ */
+declare function internalKindToLspKind(k: SymbolKind): number | null;
+
+export { FileMeta, IndexStats, IndexStore, SearchResult, Symbol, SymbolKind, SymbolLang, buildBm25Index, buildIndexableText, internalKindToLspKind, lspKindToInternalKind, tokenise };