raggrep 0.7.1 → 0.8.1

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

@@ -16,3 +16,5 @@ export type { FileIntrospection, ProjectStructure, Project, ProjectType, Scope,
 export type { FileConvention, ConventionCategory, FrameworkConventions, ConventionMatch, } from "./conventions";
 export type { LiteralType, LiteralMatchType, LiteralConfidence, LiteralDetectionMethod, ExtractedLiteral, DetectedLiteral, QueryLiteralParseResult, LiteralMatch, LiteralIndexEntry, LiteralIndexData, } from "./literal";
 export { LITERAL_SCORING } from "./literal";
+export type { SynonymGrade, Synonym, SynonymEntry, Lexicon, ExpandedTerm, ExpandedQuery, ExpansionOptions, } from "./lexicon";
+export { DEFAULT_EXPANSION_OPTIONS, EXPANSION_WEIGHTS } from "./lexicon";

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

@@ -0,0 +1,99 @@
+/**
+ * Lexicon Types
+ *
+ * Type definitions for Structured Semantic Expansion (SSE).
+ * SSE improves search recall by expanding query terms with domain-specific synonyms.
+ *
+ * This is a pure domain entity with no external dependencies.
+ */
+/**
+ * Correlation grade for synonyms.
+ * Determines how much weight a synonym contributes to scoring.
+ *
+ * - strong: Near-equivalent concepts (function ↔ method)
+ * - moderate: Related but distinct (function ↔ handler)
+ * - weak: Loosely associated (auth ↔ security)
+ */
+export type SynonymGrade = "strong" | "moderate" | "weak";
+/**
+ * A single synonym with its correlation grade.
+ */
+export interface Synonym {
+    /** The synonym term */
+    term: string;
+    /** Correlation strength with the parent term */
+    grade: SynonymGrade;
+}
+/**
+ * A synonym entry in the lexicon.
+ */
+export interface SynonymEntry {
+    /** The canonical term */
+    term: string;
+    /** Synonyms with their correlation grades */
+    synonyms: Synonym[];
+    /** Optional context restriction (e.g., "typescript", "database") */
+    context?: string;
+}
+/**
+ * The lexicon containing all synonym mappings.
+ */
+export interface Lexicon {
+    /** Version for compatibility checking */
+    version: string;
+    /** All synonym entries */
+    entries: SynonymEntry[];
+    /** Optional module-specific overrides */
+    moduleOverrides?: Record<string, SynonymEntry[]>;
+}
+/**
+ * An expanded term with weight information.
+ */
+export interface ExpandedTerm {
+    /** The term (original or synonym) */
+    term: string;
+    /** Weight for scoring (1.0 for original, lower for synonyms) */
+    weight: number;
+    /** How this term was derived */
+    source: "original" | "strong" | "moderate" | "weak";
+    /** The original term this was expanded from (if synonym) */
+    expandedFrom?: string;
+}
+/**
+ * Result of expanding a query.
+ */
+export interface ExpandedQuery {
+    /** Original query string */
+    originalQuery: string;
+    /** Original query terms (tokenized) */
+    originalTerms: string[];
+    /** All terms including expansions with weights */
+    expandedTerms: ExpandedTerm[];
+    /** Query string with expansions (for embedding) */
+    expandedQueryString: string;
+    /** Whether any expansion occurred */
+    wasExpanded: boolean;
+}
+/**
+ * Options for query expansion.
+ */
+export interface ExpansionOptions {
+    /** Maximum expansion depth (passes). Default: 1 */
+    maxDepth?: number;
+    /** Include weak synonyms. Default: true */
+    includeWeak?: boolean;
+    /** Maximum total terms after expansion. Default: 20 */
+    maxTerms?: number;
+    /** Minimum term length to expand. Default: 2 */
+    minTermLength?: number;
+    /** Context filter (only use entries matching this context) */
+    context?: string;
+}
+/**
+ * Default expansion options.
+ */
+export declare const DEFAULT_EXPANSION_OPTIONS: Required<Omit<ExpansionOptions, "context">>;
+/**
+ * Weights applied to synonyms by grade.
+ */
+export declare const EXPANSION_WEIGHTS: Record<SynonymGrade, number>;

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

@@ -12,3 +12,5 @@ export { createLineBasedChunks, createSingleChunk, generateChunkId, DEFAULT_CHUN
 export { parseQueryLiterals } from "./queryLiteralParser";
 export { extractLiterals, extractLiteralsWithReferences, } from "./literalExtractor";
 export { calculateLiteralMultiplier, calculateMaxMultiplier, calculateLiteralContribution, applyLiteralBoost, mergeWithLiteralBoost, LITERAL_SCORING_CONSTANTS, type LiteralScoreContribution, type MergeInput, type MergeOutput, } from "./literalScorer";
+export { getSynonyms, expandQuery, DEFAULT_LEXICON, EXPANSION_WEIGHTS, DEFAULT_EXPANSION_OPTIONS, } from "./lexicon";
+export { extractJsonPaths, extractJsonKeywords } from "./jsonPathExtractor";

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

@@ -0,0 +1,29 @@
+/**
+ * JSON Path Extractor
+ *
+ * Extracts dot-notation key paths from JSON objects as literals.
+ * Used for literal-based indexing of JSON files.
+ *
+ * @example
+ * // user.json: { name: { first: "john" } }
+ * extractJsonPaths({ name: { first: "john" } }, "user")
+ * // Returns literals for: "user.name", "user.name.first"
+ */
+import type { ExtractedLiteral } from "../entities/literal";
+/**
+ * Extract all key paths from a JSON object as literals.
+ * Prefixes all paths with the filename (without extension).
+ *
+ * @param obj - Parsed JSON object
+ * @param fileBasename - Filename without extension (e.g., "user" from "user.json")
+ * @returns Array of literals representing all dot-notation paths
+ */
+export declare function extractJsonPaths(obj: unknown, fileBasename: string): ExtractedLiteral[];
+/**
+ * Extract keywords from JSON for BM25 indexing.
+ * Extracts both keys and string values.
+ *
+ * @param obj - Parsed JSON object
+ * @returns Array of keywords for BM25 indexing
+ */
+export declare function extractJsonKeywords(obj: unknown): string[];

package/dist/domain/services/jsonPathExtractor.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * JSON Path Extractor Tests
+ */
+export {};

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

@@ -0,0 +1,45 @@
+/**
+ * Lexicon Service
+ *
+ * Provides query expansion using domain-specific synonyms.
+ * Part of Structured Semantic Expansion (SSE) for improved search recall.
+ *
+ * This is a pure domain service with no external dependencies.
+ */
+import type { Lexicon, Synonym, ExpandedQuery, ExpansionOptions } from "../entities/lexicon";
+import { DEFAULT_EXPANSION_OPTIONS, EXPANSION_WEIGHTS } from "../entities/lexicon";
+/**
+ * Default lexicon for programming domain.
+ *
+ * Contains common synonyms for code-related terms.
+ * Grades indicate correlation strength:
+ * - strong: Near-equivalent (function ↔ method)
+ * - moderate: Related but distinct (function ↔ handler)
+ * - weak: Loosely associated (auth ↔ security)
+ */
+export declare const DEFAULT_LEXICON: Lexicon;
+/**
+ * Get synonyms for a term from the lexicon.
+ *
+ * @param term - The term to look up
+ * @param lexicon - The lexicon to use (defaults to DEFAULT_LEXICON)
+ * @returns Array of synonyms with grades, or empty array if not found
+ */
+export declare function getSynonyms(term: string, lexicon?: Lexicon): Synonym[];
+/**
+ * Expand a query using the lexicon.
+ *
+ * @param query - The original query string
+ * @param lexicon - The lexicon to use (defaults to DEFAULT_LEXICON)
+ * @param options - Expansion options
+ * @returns Expanded query with weights
+ */
+export declare function expandQuery(query: string, lexicon?: Lexicon, options?: ExpansionOptions): ExpandedQuery;
+/**
+ * Get expansion weights by grade (re-exported for convenience).
+ */
+export { EXPANSION_WEIGHTS };
+/**
+ * Get default expansion options (re-exported for convenience).
+ */
+export { DEFAULT_EXPANSION_OPTIONS };

package/dist/domain/services/lexicon.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lexicon Service Tests
+ *
+ * Tests for query expansion using domain-specific synonyms.
+ */
+export {};