raggrep 0.8.4 → 0.9.0

package/dist/infrastructure/storage/symbolicIndex.d.ts

@@ -6,7 +6,7 @@
  *
  * Structure:
  *   .raggrep/index/<module>/symbolic/
- *   ├── _meta.json    (BM25 statistics)
+ *   ├── _meta.json    (BM25 statistics + serialized BM25 data)
  *   └── <filepath>.json (per-file summaries)
  */
 import type { FileSummary } from "../../domain/entities";
@@ -14,6 +14,7 @@ import type { FileSummary } from "../../domain/entities";
  * Symbolic Index Manager
  *
  * Manages the keyword-based index for fast file filtering.
+ * Supports incremental updates to avoid full rebuilds.
  */
 export declare class SymbolicIndex {
     private meta;
@@ -27,15 +28,29 @@ export declare class SymbolicIndex {
      */
     initialize(): Promise<void>;
     /**
-     * Add or update a file summary
+     * Add or update a file summary (for batch operations, use with buildBM25Index)
      */
     addFile(summary: FileSummary): void;
     /**
-     * Remove a file from the index
+     * Add or update a file summary with incremental BM25 update.
+     * Use this for incremental indexing instead of addFile + buildBM25Index.
+     */
+    addFileIncremental(summary: FileSummary): void;
+    /**
+     * Remove a file from the index (for batch operations)
      */
     removeFile(filepath: string): boolean;
     /**
-     * Build BM25 index from file summaries
+     * Remove a file from the index with incremental BM25 update.
+     * Use this for incremental indexing.
+     */
+    removeFileIncremental(filepath: string): boolean;
+    /**
+     * Get tokens for a file summary (for BM25 indexing)
+     */
+    private getTokensForSummary;
+    /**
+     * Build BM25 index from file summaries (full rebuild)
      */
     buildBM25Index(): void;
     /**
@@ -51,9 +66,14 @@ export declare class SymbolicIndex {
      */
     getFileSummary(filepath: string): FileSummary | undefined;
     /**
-     * Save the index to disk (per-file structure)
+     * Save the index to disk (per-file structure with BM25 serialization)
      */
     save(): Promise<void>;
+    /**
+     * Save only the updated file summaries (for incremental saves)
+     * @param filepaths - List of filepaths that were updated
+     */
+    saveIncremental(filepaths: string[]): Promise<void>;
     /**
      * Load the index from disk
      */

package/dist/modules/data/json/index.d.ts

@@ -48,7 +48,8 @@ export declare class JsonModule implements IndexModule {
     initialize(config: ModuleConfig): Promise<void>;
     indexFile(filepath: string, content: string, ctx: IndexContext): Promise<FileIndex | null>;
     /**
-     * Finalize indexing by building and saving the symbolic and literal indexes
+     * Finalize indexing by building and saving the symbolic and literal indexes.
+     * Uses incremental updates when possible to avoid full rebuilds.
      */
     finalize(ctx: IndexContext): Promise<void>;
     /**

package/dist/modules/language/typescript/index.d.ts

@@ -48,7 +48,8 @@ export declare class TypeScriptModule implements IndexModule {
     initialize(config: ModuleConfig): Promise<void>;
     indexFile(filepath: string, content: string, ctx: IndexContext): Promise<FileIndex | null>;
     /**
-     * Finalize indexing by building and saving the symbolic and literal indexes
+     * Finalize indexing by building and saving the symbolic and literal indexes.
+     * Uses incremental updates when possible to avoid full rebuilds.
      */
     finalize(ctx: IndexContext): Promise<void>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raggrep",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "Local filesystem-based RAG system for codebases - semantic search using local embeddings",
   "type": "module",
   "main": "./dist/index.js",