raggrep 0.1.0 → 0.1.4

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/fileSummary.d.ts

@@ -7,6 +7,19 @@
  * Stored as individual files in: .raggrep/index/<module>/symbolic/<filepath>.json
  */
 import type { ChunkType } from "./chunk";
+/**
+ * Path context information for structural search boosting.
+ */
+export interface PathContext {
+    /** Directory segments (excluding filename) */
+    segments: string[];
+    /** Detected architectural layer (service, controller, repository, etc.) */
+    layer?: string;
+    /** Detected feature domain (auth, users, payments, etc.) */
+    domain?: string;
+    /** Path depth (number of directory levels) */
+    depth: number;
+}
 /**
  * Lightweight file summary for fast filtering.
  *
@@ -26,6 +39,11 @@ export interface FileSummary {
     exports: string[];
     /** ISO timestamp of when the file was last modified */
     lastModified: string;
+    /**
+     * Parsed path context for structural boosting.
+     * Includes detected layer, domain, and path depth.
+     */
+    pathContext?: PathContext;
 }
 /**
  * Metadata for the symbolic 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

@@ -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/keywords.d.ts

@@ -9,6 +9,11 @@
  * These appear in almost every code file and don't add search value.
  */
 export declare const COMMON_KEYWORDS: Set<string>;
+/**
+ * Common architectural layer patterns in file names/paths.
+ * Used to detect the layer a file belongs to.
+ */
+export declare const LAYER_PATTERNS: Record<string, string[]>;
 /**
  * Extract keywords from code content and optional name.
  *
@@ -21,7 +26,47 @@ export declare function extractKeywords(content: string, name?: string, maxKeywo
 /**
  * Extract keywords from a file path.
  *
+ * Enhanced extraction that:
+ * - Splits camelCase/PascalCase filenames
+ * - Extracts directory segments
+ * - Recognizes common patterns (Service, Controller, etc.)
+ *
  * @param filepath - File path to extract keywords from
  * @returns Array of keywords from path segments
  */
 export declare function extractPathKeywords(filepath: string): string[];
+/**
+ * Path context information extracted from a file path.
+ */
+export interface PathContext {
+    /** Directory segments (excluding filename) */
+    segments: string[];
+    /** Detected architectural layer (service, controller, repository, etc.) */
+    layer?: string;
+    /** Detected feature domain (auth, users, payments, etc.) */
+    domain?: string;
+    /** Path depth (number of directory levels) */
+    depth: number;
+    /** Keywords extracted from the path */
+    keywords: string[];
+}
+/**
+ * Parse a file path and extract structural context.
+ *
+ * This helps with:
+ * - Boosting files in related directories
+ * - Understanding architectural layer
+ * - Grouping by feature domain
+ *
+ * @param filepath - File path to parse
+ * @returns Parsed path context
+ */
+export declare function parsePathContext(filepath: string): PathContext;
+/**
+ * Generate a path context string for embedding.
+ * This is prepended to content to give the embedding model path awareness.
+ *
+ * @param pathContext - Parsed path context
+ * @returns A string representation of the path context
+ */
+export declare function formatPathContextForEmbedding(pathContext: PathContext): string;

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.
  *