minovative-mind-cli 2.9.0 → 2.10.0

package/dist/services/orchestration/investigationCache.d.ts

@@ -1,25 +1,100 @@
+export interface SemanticMetadata {
+    topics: string[];
+    components: string[];
+    intent: string;
+    reasoning?: string;
+}
 export interface InvestigationCacheEntry {
     promptHash: string;
+    normalizedPrompt: string;
+    topics?: string[];
+    components?: string[];
+    intent?: string;
+    semanticSignature?: string;
     relevantFiles: string[];
     summary: string;
     workspaceFingerprint: string;
     createdAt: number;
+    lastAccessedAt: number;
+    hitCount?: number;
 }
 export interface InvestigationCacheStore {
     entries: Record<string, InvestigationCacheEntry>;
+    totalHits?: number;
+    totalMisses?: number;
+}
+export interface LookupInvestigationOptions {
+    abortSignal?: AbortSignal;
+    allowSemanticFallback?: boolean;
+    semanticSession?: any;
+    onProgress?: (message: string) => void;
+    fuzzyThreshold?: number;
+    semanticThreshold?: number;
 }
+export interface LookupInvestigationResult {
+    entry: InvestigationCacheEntry;
+    bytesSaved: number;
+    matchTier: 'exact' | 'fuzzy' | 'semantic';
+    similarityScore?: number;
+}
+export declare const MAX_CACHE_SIZE_BYTES: number;
+export declare const DEFAULT_FUZZY_THRESHOLD = 0.85;
+export declare const DEFAULT_SEMANTIC_THRESHOLD = 0.7;
+/**
+ * Normalizes prompt by trimming, collapsing whitespace, and stripping common conversation prefixes.
+ */
 export declare function normalizePrompt(prompt: string): string;
+/**
+ * Computes SHA-256 hash of a normalized prompt string.
+ */
 export declare function hashPrompt(normalized: string): string;
+/**
+ * Generates a deterministic signature from topics, components, and intent.
+ */
+export declare function generateSemanticSignature(topics: string[], components: string[], intent?: string): string;
+/**
+ * Offline heuristic semantic metadata extractor.
+ */
+export declare function extractHeuristicSemanticMetadata(prompt: string, relevantFiles?: string[]): SemanticMetadata;
+/**
+ * Classifies prompt semantic intent and entity tags using AI or offline heuristic fallback.
+ */
+export declare function classifySemanticIntent(userPrompt: string, abortSignal?: AbortSignal, customSession?: any, timeoutMs?: number): Promise<SemanticMetadata | null>;
+/**
+ * Computes a SHA-256 fingerprint of the relevant files' mtime and sizes.
+ */
 export declare function generateWorkspaceFingerprint(workspaceRoot: string, relevantFiles: string[]): Promise<string>;
-export declare function lookupInvestigation(workspaceRoot: string, userPrompt: string): Promise<{
-    entry: InvestigationCacheEntry;
-    bytesSaved: number;
-} | null>;
-export declare function saveInvestigation(workspaceRoot: string, userPrompt: string, relevantFiles: string[], summary: string): Promise<void>;
+/**
+ * Enforces LRU eviction to keep cache store below MAX_CACHE_SIZE_BYTES (5MB).
+ */
+export declare function pruneCacheStore(store: InvestigationCacheStore): void;
+/**
+ * Looks up cached investigation results using a 2-Tier matching pipeline:
+ * - Tier 1A: Exact hash match
+ * - Tier 1B: Local fuzzy Levenshtein & token similarity match
+ * - Tier 2: AI semantic topic & component classification match
+ * All candidates validate the workspace fingerprint before returning.
+ */
+export declare function lookupInvestigation(workspaceRoot: string, userPrompt: string, options?: LookupInvestigationOptions): Promise<LookupInvestigationResult | null>;
+/**
+ * Saves investigation context with semantic tagging, workspace fingerprint, and LRU pruning.
+ */
+export declare function saveInvestigation(workspaceRoot: string, userPrompt: string, relevantFiles: string[], summary: string, semanticMetadata?: Partial<SemanticMetadata>, abortSignal?: AbortSignal): Promise<void>;
+/**
+ * Invalidates cache entries that reference any changed files.
+ */
 export declare function invalidateFilesFromInvestigationCache(workspaceRoot: string, changedFiles: string[]): Promise<void>;
+/**
+ * Clears all entries in the investigation cache.
+ */
+export declare function clearInvestigationCache(workspaceRoot: string): void;
+/**
+ * Returns cache statistics for inspection and telemetry.
+ */
 export declare function getInvestigationCacheStats(workspaceRoot: string): {
     entries: number;
     sizeBytes: number;
     hitCount: number;
     missCount: number;
+    topicsCount: number;
 };