raggrep 0.1.3 → 0.1.5

package/dist/composition.d.ts

@@ -8,10 +8,10 @@
  * This is the only file that knows about concrete implementations.
  * Everything else depends only on interfaces (ports).
  */
-import type { Config } from './domain/entities';
-import type { FileSystem } from './domain/ports';
-import type { IndexModule, IndexContext, SearchContext } from './types';
-import { FileIndexStorage } from './infrastructure/storage';
+import type { Config } from "./domain/entities";
+import type { FileSystem } from "./domain/ports";
+import type { IndexModule, IndexContext, SearchContext } from "./types";
+import { FileIndexStorage } from "./infrastructure/storage";
 /**
  * Container for all application services.
  * Created once and passed to use cases.
@@ -27,9 +27,9 @@ export interface ServiceContainer {
  * Create a service container for a specific project directory.
  */
 export declare function createServiceContainer(rootDir: string): Promise<ServiceContainer>;
-import type { IndexDirectoryDependencies } from './application/usecases/indexDirectory';
-import type { SearchIndexDependencies } from './application/usecases/searchIndex';
-import type { CleanupIndexDependencies } from './application/usecases/cleanupIndex';
+import type { IndexDirectoryDependencies } from "./domain/usecases/indexDirectory";
+import type { SearchIndexDependencies } from "./domain/usecases/searchIndex";
+import type { CleanupIndexDependencies } from "./domain/usecases/cleanupIndex";
 /**
  * Create dependencies for the indexDirectory use case.
  */

package/dist/domain/entities/chunk.d.ts

@@ -7,7 +7,7 @@
 /**
  * Types of code chunks that can be extracted from source files.
  */
-export type ChunkType = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'block' | 'file';
+export type ChunkType = "function" | "class" | "interface" | "type" | "enum" | "variable" | "block" | "file";
 /**
  * A chunk of code or text that has been parsed and can be indexed.
  *

package/dist/domain/entities/fileIndex.d.ts

@@ -4,7 +4,7 @@
  * Represents the indexed data for a single source file.
  * This is a Tier 2 index structure containing full chunk data and embeddings.
  */
-import type { Chunk } from './chunk';
+import type { Chunk } from "./chunk";
 /**
  * Indexed data for a single file (Tier 2 index).
  *

package/dist/domain/entities/index.d.ts

@@ -8,7 +8,7 @@ export type { Chunk, ChunkType } from "./chunk";
 export { createChunkId } from "./chunk";
 export type { FileIndex, FileManifestEntry, ModuleManifest, GlobalManifest, } from "./fileIndex";
 export type { FileSummary, SymbolicIndexMeta, Tier1Manifest, } from "./fileSummary";
-export type { SearchResult, SearchOptions } from "./searchResult";
+export type { SearchResult, SearchOptions, SearchContributions, CoreContribution, LanguageContribution, IntrospectionContribution, } from "./searchResult";
 export { DEFAULT_SEARCH_OPTIONS } from "./searchResult";
 export type { Config, ModuleConfig } from "./config";
 export { DEFAULT_IGNORE_PATHS, DEFAULT_EXTENSIONS, createDefaultConfig, } from "./config";

package/dist/domain/entities/searchResult.d.ts

@@ -3,7 +3,50 @@
  *
  * Represents a single result from a search query.
  */
-import type { Chunk } from './chunk';
+import type { Chunk } from "./chunk";
+/**
+ * Contribution from the core index.
+ */
+export interface CoreContribution {
+    /** Symbol name match score (0-1) */
+    symbolMatch: number;
+    /** BM25 keyword match score (0-1) */
+    keywordMatch: number;
+}
+/**
+ * Contribution from a language-specific index.
+ */
+export interface LanguageContribution {
+    /** Semantic embedding similarity (0-1) */
+    semanticMatch: number;
+    /** BM25 keyword match score (0-1) */
+    keywordMatch: number;
+}
+/**
+ * Contribution from introspection boosting.
+ */
+export interface IntrospectionContribution {
+    /** Boost from domain match */
+    domainBoost: number;
+    /** Boost from layer match */
+    layerBoost: number;
+    /** Boost from scope match */
+    scopeBoost: number;
+    /** Boost from path segment match */
+    pathBoost: number;
+}
+/**
+ * Tracks which indexes contributed to a search result's score.
+ * Used for learning and tuning.
+ */
+export interface SearchContributions {
+    /** Core index contribution */
+    core?: CoreContribution;
+    /** Language-specific index contribution (keyed by module ID) */
+    language?: Record<string, LanguageContribution>;
+    /** Introspection boost contribution */
+    introspection?: IntrospectionContribution;
+}
 /**
  * A search result with relevance score and source information.
  */
@@ -12,10 +55,12 @@ export interface SearchResult {
     filepath: string;
     /** The matching chunk */
     chunk: Chunk;
-    /** Relevance score (0-1, higher is better) */
+    /** Final relevance score (0-1, higher is better) */
     score: number;
     /** ID of the module that produced this result */
     moduleId: string;
+    /** Contribution tracking for learning */
+    contributions?: SearchContributions;
     /** Additional context from the search (e.g., semantic vs keyword scores) */
     context?: Record<string, unknown>;
 }

package/dist/domain/index.d.ts

@@ -5,7 +5,9 @@
  * - Entities: Core data structures
  * - Ports: Interfaces for external dependencies
  * - Services: Pure business logic and algorithms
+ * - Use Cases: Application business logic
  */
-export * from './entities';
-export * from './ports';
-export * from './services';
+export * from "./entities";
+export * from "./ports";
+export * from "./services";
+export * from "./usecases";

package/dist/domain/ports/embedding.d.ts

@@ -8,7 +8,7 @@
 /**
  * Available embedding model names
  */
-export type EmbeddingModelName = 'all-MiniLM-L6-v2' | 'all-MiniLM-L12-v2' | 'bge-small-en-v1.5' | 'paraphrase-MiniLM-L3-v2';
+export type EmbeddingModelName = "all-MiniLM-L6-v2" | "all-MiniLM-L12-v2" | "bge-small-en-v1.5" | "paraphrase-MiniLM-L3-v2";
 /**
  * Configuration for embedding provider
  */
@@ -54,7 +54,3 @@ export interface EmbeddingProvider {
      */
     dispose?(): Promise<void>;
 }
-/**
- * Calculate cosine similarity between two vectors
- */
-export declare function cosineSimilarity(a: number[], b: number[]): number;

package/dist/domain/ports/index.d.ts

@@ -4,7 +4,6 @@
  * Interfaces defining what the domain needs from external systems.
  * These are implemented by infrastructure adapters.
  */
-export type { FileSystem, FileStats } from './filesystem';
-export type { EmbeddingProvider, EmbeddingConfig, EmbeddingModelName } from './embedding';
-export { cosineSimilarity } from './embedding';
-export type { IndexStorage } from './storage';
+export type { FileSystem, FileStats } from "./filesystem";
+export type { EmbeddingProvider, EmbeddingConfig, EmbeddingModelName } from "./embedding";
+export type { IndexStorage } from "./storage";

package/dist/domain/services/bm25.d.ts

@@ -71,6 +71,30 @@ export declare class BM25Index {
      * Clear the index.
      */
     clear(): void;
+    /**
+     * Add a single document by ID and pre-computed tokens.
+     *
+     * @param id - Document identifier
+     * @param tokens - Pre-computed tokens
+     */
+    addDocument(id: string, tokens: string[]): void;
+    /**
+     * Serialize the index to a JSON-compatible object.
+     */
+    serialize(): BM25SerializedData;
+    /**
+     * Deserialize a BM25 index from saved data.
+     */
+    static deserialize(data: BM25SerializedData): BM25Index;
+}
+/**
+ * Serialized BM25 index data.
+ */
+export interface BM25SerializedData {
+    documents: Record<string, string[]>;
+    avgDocLength: number;
+    documentFrequencies: Record<string, number>;
+    totalDocs: number;
 }
 /**
  * Normalize a raw score to 0-1 range using sigmoid function.

package/dist/domain/services/index.d.ts

@@ -4,5 +4,6 @@
  * Pure algorithms and business logic with no external dependencies.
  * These services operate only on domain entities and primitive data.
  */
-export { BM25Index, tokenize, normalizeScore, type BM25Document, type BM25Result, } from './bm25';
-export { extractKeywords, extractPathKeywords, COMMON_KEYWORDS, } from './keywords';
+export { BM25Index, tokenize, normalizeScore, type BM25Document, type BM25Result, type BM25SerializedData, } from "./bm25";
+export { extractKeywords, extractPathKeywords, parsePathContext, formatPathContextForEmbedding, COMMON_KEYWORDS, type PathContext, } from "./keywords";
+export { cosineSimilarity, euclideanDistance } from "./similarity";

package/dist/domain/services/similarity.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Similarity Service
+ *
+ * Pure mathematical functions for computing vector similarity.
+ * No external dependencies.
+ */
+/**
+ * Calculate cosine similarity between two vectors.
+ *
+ * @param a - First vector
+ * @param b - Second vector
+ * @returns Similarity score between -1 and 1 (1 = identical, 0 = orthogonal, -1 = opposite)
+ * @throws Error if vectors have different lengths
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Calculate Euclidean distance between two vectors.
+ *
+ * @param a - First vector
+ * @param b - Second vector
+ * @returns Distance (0 = identical, larger = more different)
+ */
+export declare function euclideanDistance(a: number[], b: number[]): number;

package/dist/{application → domain}/usecases/cleanupIndex.d.ts

@@ -3,8 +3,8 @@
  *
  * Removes stale index entries for files that no longer exist.
  */
-import type { Config, ModuleManifest } from '../../domain/entities';
-import type { FileSystem } from '../../domain/ports';
+import type { Config, ModuleManifest } from '../entities';
+import type { FileSystem } from '../ports';
 import type { IndexModule } from '../../types';
 /**
  * Result of cleanup for a single module

package/dist/{application → domain}/usecases/indexDirectory.d.ts

@@ -5,8 +5,8 @@
  * This is an application-level use case that coordinates domain entities
  * and infrastructure services.
  */
-import type { Config } from '../../domain/entities';
-import type { FileSystem } from '../../domain/ports';
+import type { Config } from '../entities';
+import type { FileSystem } from '../ports';
 import type { IndexModule } from '../../types';
 /**
  * Result of indexing with a single module

package/dist/{application → domain}/usecases/searchIndex.d.ts

@@ -3,8 +3,8 @@
  *
  * Orchestrates searching the indexed codebase.
  */
-import type { Config, SearchResult, SearchOptions } from '../../domain/entities';
-import type { FileSystem } from '../../domain/ports';
+import type { Config, SearchResult, SearchOptions } from '../entities';
+import type { FileSystem } from '../ports';
 import type { IndexModule, FileIndex } from '../../types';
 /**
  * Options for the search use case

package/dist/index.d.ts

@@ -17,11 +17,11 @@
  * await raggrep.cleanup('/path/to/project');
  * ```
  */
-import type { IndexResult, IndexOptions, CleanupResult } from './indexer';
-import { formatSearchResults } from './search';
-import type { SearchOptions, SearchResult } from './types';
-export type { IndexResult, IndexOptions, CleanupResult } from './indexer';
-export type { SearchOptions, SearchResult, Chunk, FileIndex } from './types';
+import type { IndexResult, IndexOptions, CleanupResult } from "./app/indexer";
+import { formatSearchResults } from "./app/search";
+import type { SearchOptions, SearchResult } from "./types";
+export type { IndexResult, IndexOptions, CleanupResult } from "./app/indexer";
+export type { SearchOptions, SearchResult, Chunk, FileIndex } from "./types";
 /**
  * Index a directory for semantic search.
  *