crewly 1.13.1 → 1.14.0

package/dist/backend/backend/src/services/knowledge/knowledge-search.service.d.ts

@@ -1,241 +0,0 @@
-/**
- * Knowledge Search Service
- *
- * Provides pluggable search strategies for knowledge documents.
- * Defaults to `Fts5SearchStrategy` (SQLite FTS5 with native BM25
- * ranking) and falls back to `KeywordSearchStrategy` for docs not
- * yet indexed. The Gemini embedding and local-vector strategies
- * remain available for callers that need semantic similarity but
- * are no longer wired as the default.
- *
- * @module services/knowledge/knowledge-search.service
- */
-import type { KnowledgeDocumentSummary, KnowledgeScope } from '../../types/knowledge.types.js';
-/**
- * Apply temporal decay to a search score (#154).
- * Score decays by half every TEMPORAL_DECAY_HALF_LIFE_DAYS days.
- * Documents tagged with evergreen/decision tags bypass decay entirely.
- *
- * @param score - Raw relevance score
- * @param createdAt - ISO timestamp of document creation
- * @param tags - Document tags
- * @returns Decayed score
- */
-export declare function applyTemporalDecay(score: number, createdAt: string, tags: string[]): number;
-/**
- * A document scored by a search strategy.
- */
-export interface ScoredDocument {
-    /** The matched document summary */
-    document: KnowledgeDocumentSummary;
-    /** Relevance score (higher is more relevant) */
-    score: number;
-}
-/**
- * Search options passed to strategies.
- */
-export interface SearchOptions {
-    scope?: KnowledgeScope;
-    projectPath?: string;
-    category?: string;
-    limit?: number;
-}
-/**
- * Strategy interface for scoring documents against a query.
- */
-export interface KnowledgeSearchStrategy {
-    /**
-     * Score documents against a query. Returns documents sorted by relevance.
-     *
-     * @param query - The search query
-     * @param documents - Candidate documents to score (may be ignored by some strategies)
-     * @param options - Optional scope and filtering parameters
-     * @returns Documents sorted by descending score
-     */
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * Keyword-based search strategy (default fallback, zero dependencies).
- *
- * Splits the query into words and scores documents by matching against
- * title (3x weight), tags (2x weight), and preview (1x weight).
- */
-export declare class KeywordSearchStrategy implements KnowledgeSearchStrategy {
-    /**
-     * Score documents using keyword matching.
-     *
-     * @param query - Search query text
-     * @param documents - Documents to score
-     * @param options - Optional search parameters (ignored)
-     * @returns Scored documents sorted by relevance
-     */
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * SQLite FTS5-based search strategy (V2 Default).
- *
- * Utilizes the FTS5 virtual table for lightning-fast full-text search
- * with native BM25 ranking. Bypasses the memory-intensive candidate
- * listing for large knowledge bases.
- */
-export declare class Fts5SearchStrategy implements KnowledgeSearchStrategy {
-    private readonly logger;
-    private readonly fallback;
-    private readonly globalFts5;
-    private readonly projectFts5Cache;
-    constructor();
-    private getProjectFts5;
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * Gemini embedding-based semantic search strategy.
- *
- * @deprecated Use Fts5SearchStrategy for technical knowledge.
- * Semantic search is now primarily for Agent Memory via MemoryService.
- *
- * Calls the Gemini Embedding API to embed query text, then computes
- * cosine similarity against document embeddings. Falls back to
- * KeywordSearchStrategy if the API call fails.
- */
-export declare class GeminiEmbeddingStrategy implements KnowledgeSearchStrategy {
-    private readonly apiKey;
-    private readonly fallback;
-    private readonly logger;
-    /**
-     * Creates a GeminiEmbeddingStrategy instance.
-     *
-     * @param apiKey - Gemini API key for embedding requests
-     */
-    constructor(apiKey: string);
-    /**
-     * Embed a single text string via the Gemini API.
-     *
-     * @param text - Text to embed
-     * @returns Embedding vector, or null on failure
-     */
-    private embed;
-    /**
-     * Score documents using Gemini embeddings and cosine similarity.
-     * Falls back to keyword search if embedding fails.
-     *
-     * @param query - Search query text
-     * @param documents - Documents to score
-     * @param options - Optional search parameters
-     * @returns Scored documents sorted by relevance
-     */
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * Local vector search strategy using SQLite-backed VectorStoreService.
- *
- * @deprecated Use Fts5SearchStrategy for primary knowledge retrieval.
- *
- * Stores embeddings locally on-device so that recall works offline.
- * Uses the Gemini API to generate embeddings (when available) and
- * persists them in the local vector store. Subsequent searches skip
- * the embedding API for documents that already have stored vectors.
- * Falls back to keyword search when no API key is configured or
- * when embedding generation fails.
- */
-export declare class LocalVectorSearchStrategy implements KnowledgeSearchStrategy {
-    private readonly vectorStore;
-    private readonly apiKey;
-    private readonly fallback;
-    private readonly logger;
-    /**
-     * Creates a LocalVectorSearchStrategy instance.
-     *
-     * @param apiKey - Optional Gemini API key for generating embeddings
-     */
-    constructor(apiKey?: string);
-    /**
-     * Embed a single text string via the Gemini API.
-     *
-     * @param text - Text to embed
-     * @returns Embedding vector, or null on failure
-     */
-    private embed;
-    /**
-     * Get or create an embedding for a document, persisting it locally.
-     *
-     * @param docId - Document identifier
-     * @param docText - Text to embed (used only if no stored embedding)
-     * @param scope - Storage scope
-     * @param projectPath - Project path for project scope
-     * @returns The embedding vector, or null if unavailable
-     */
-    private getOrCreateEmbedding;
-    /**
-     * Score documents using local vector search with cosine similarity.
-     * Falls back to keyword search when embeddings are unavailable.
-     *
-     * @param query - Search query text
-     * @param documents - Documents to score
-     * @param options - Optional search parameters
-     * @returns Scored documents sorted by relevance
-     */
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * BM25-inspired keyword scoring for hybrid search (#152).
- *
- * Computes a simplified BM25-like score for a document against a query.
- * Uses term frequency with diminishing returns (k1 saturation).
- *
- * @param query - Search query text
- * @param docText - Document text to score
- * @returns BM25-inspired score (higher is better)
- */
-export declare function bm25Score(query: string, docText: string): number;
-/**
- * Hybrid search strategy: vector similarity (70%) + BM25 keywords (30%) (#152).
- *
- * Combines semantic vector search with BM25 keyword matching for more
- * accurate retrieval. Proper nouns, technical terms, and IDs are caught
- * by BM25 while conceptual matches come from vector similarity.
- */
-export declare class HybridSearchStrategy implements KnowledgeSearchStrategy {
-    private readonly vectorStrategy;
-    private readonly keywordStrategy;
-    private readonly logger;
-    private readonly vectorWeight;
-    private readonly keywordWeight;
-    constructor(apiKey?: string, vectorWeight?: number, keywordWeight?: number);
-    search(query: string, documents: KnowledgeDocumentSummary[], options?: SearchOptions): Promise<ScoredDocument[]>;
-}
-/**
- * Knowledge Search Service singleton.
- *
- * Strategy selection priority:
- * 1. Fts5SearchStrategy (V2 Default — SQLite FTS5)
- * 2. HybridSearchStrategy (when embedding API key is set — vector 70% + BM25 30%) (#152)
- * 3. KeywordSearchStrategy (default, zero dependencies)
- */
-export declare class KnowledgeSearchService {
-    private static instance;
-    private readonly strategy;
-    private readonly logger;
-    private constructor();
-    /**
-     * Get the singleton instance.
-     *
-     * @returns KnowledgeSearchService instance
-     */
-    static getInstance(): KnowledgeSearchService;
-    /**
-     * Reset the singleton (for testing).
-     */
-    static resetInstance(): void;
-    /**
-     * Search knowledge documents using the configured strategy.
-     *
-     * @param query - Search query text
-     * @param scope - Document scope ('global' or 'project')
-     * @param projectPath - Project path (required when scope is 'project')
-     * @param category - Optional category filter
-     * @param limit - Maximum number of results (default 5)
-     * @returns Matching document summaries sorted by relevance
-     */
-    search(query: string, scope: KnowledgeScope, projectPath?: string, category?: string, limit?: number): Promise<KnowledgeDocumentSummary[]>;
-}
-//# sourceMappingURL=knowledge-search.service.d.ts.map

package/dist/backend/backend/src/services/knowledge/knowledge-search.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-search.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/knowledge-search.service.ts"],"names":[],"mappings":"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"}