crewly 1.13.1 → 1.14.0

package/dist/cli/backend/src/services/knowledge/fts5-query-sanitizer.js

@@ -1,118 +0,0 @@
-/**
- * FTS5 Query Sanitizer
- *
- * Pure helper that converts an arbitrary input string into a safe SQLite FTS5
- * MATCH query via phrase-quote tokenization. Used by
- * {@link Fts5IndexService.search} so that programmatically constructed
- * agent-context strings never accidentally parse as FTS5 operators.
- *
- * **Why this helper exists.** SQLite FTS5 has a rich query grammar with
- * column filters (`column:term`), set-column lists (`{c1, c2}: term`),
- * phrase syntax (`"phrase"`), boolean operators (`AND`, `OR`, `NOT`),
- * proximity (`NEAR(...)`), prefix (`term*`), and grouping (`(...)`). When
- * arbitrary user / agent-context text is concatenated into a MATCH query,
- * these operators trigger:
- *
- * - **commas** are parsed as column-list separators →
- *   `fts5: syntax error near ","` (e.g. `"foo, bar"` blows up)
- * - **hyphens inside identifiers** like `team-leader` parse as `team`
- *   followed by column filter `-leader` → `no such column: leader`
- * - **colons** parse as column filter operator → `no such column: ...`
- * - **bare AND / OR / NOT** in mixed-case input parse as keywords
- *
- * The previous regex-strip sanitizer at `Fts5IndexService.search` only
- * removed `' " * ( ) { } [ ] ^ ~ \\` — it left commas, hyphens, colons, and
- * all FTS5 keywords intact. Result: 44 silent search failures per day
- * (22 comma + 22 hyphen) for agent recall on 2026-05-07 alone.
- *
- * **Approach (Kai's WI-E F-FTS5 triage recommendation).** Split tokens on
- * **whitespace + comma only** — NOT on word boundaries — then wrap each
- * non-empty token in double quotes for FTS5 phrase syntax. Phrases are
- * **literal** — no operator parsing happens inside the quotes — so any
- * residual operator-like content (hyphens, colons, asterisks, AND/OR/NOT
- * keywords) is neutralized. Tokens are joined with whitespace, which FTS5
- * treats as implicit AND.
- *
- * **Why split on whitespace+comma instead of word boundaries.** A token like
- * `team-leader` wrapped as the phrase `"team-leader"` is parsed by FTS5's
- * MATCH parser as a single phrase node, then internally the
- * `unicode61` tokenizer (used at index time) splits the phrase into
- * adjacent tokens `team` + `leader`. The MATCH operation thus requires
- * those tokens to appear adjacent in the document — which matches docs
- * that were indexed with `team-leader` exactly. Splitting on word
- * boundaries at query-time would produce `"team" "leader"` (loose AND),
- * matching docs with `team` and `leader` anywhere — looser than the
- * caller intended. **Kai's approach preserves precision for hyphenated
- * identifiers without losing the comma/colon-safety win.**
- *
- * **Trade-off (intentional).** This sanitizer DROPS FTS5 operator support:
- * `AND`, `OR`, `NOT`, `NEAR(...)`, column-filter prefixes, and prefix
- * wildcards (`term*`) all become literal phrases. All callers on this
- * path are auto-generated agent-context strings, not user-typed search
- * queries — they don't need operator support. If a future caller needs
- * the full FTS5 grammar, expose a separate `searchRaw()` API rather than
- * loosening this sanitizer.
- *
- * @module services/knowledge/fts5-query-sanitizer
- */
-/**
- * Convert an arbitrary input string into a safe FTS5 MATCH query via
- * phrase-quote tokenization.
- *
- * The result is one of:
- * - `''` — when the input is empty / whitespace-only / only contains
- *   delimiter characters. Callers MUST check for empty and skip the
- *   MATCH query (return empty results).
- * - `'"tok1" "tok2" ..."'` — a sequence of double-quoted phrases joined
- *   by whitespace (implicit AND in FTS5).
- *
- * Pre-existing double quotes inside a token are escaped per FTS5 phrase
- * syntax (`"` → `""`). This is defensive — auto-generated context
- * strings rarely contain quotes — but it makes the helper safely
- * reusable beyond the current call site.
- *
- * @param input - Raw query string from user input or agent-context concat.
- * @returns Safe FTS5 MATCH expression, or `''` if no tokens remain.
- *
- * @example
- * ```typescript
- * toFts5Phrase('developer session startup');
- * // → '"developer" "session" "startup"'
- *
- * toFts5Phrase('developer session startup, recent tasks, unfinished work');
- * // → '"developer" "session" "startup" "recent" "tasks" "unfinished" "work"'
- * // (comma fix — was: "syntax error near ',''")
- *
- * toFts5Phrase('team-leader session startup');
- * // → '"team-leader" "session" "startup"'
- * // (hyphen fix — was: "no such column: leader". The phrase `"team-leader"`
- * //  matches docs indexed with `team-leader` exactly, since the unicode61
- * //  tokenizer splits the phrase content the same way at both index and
- * //  query time.)
- *
- * toFts5Phrase('say "hello" world');
- * // → '"say" """hello""" "world"'    (quotes escaped as "")
- *
- * toFts5Phrase('   ,  ');             // → ''
- * toFts5Phrase('***');                // → '"***"'  (literal phrase, FTS5 strips
- *                                     //   non-word chars at tokenization → no match)
- * ```
- */
-export function toFts5Phrase(input) {
-    if (!input) {
-        return '';
-    }
-    return input
-        // Split on whitespace + comma only. NOT on word boundaries — see module
-        // doc above for why preserving hyphens/colons inside tokens is correct.
-        .split(/[\s,]+/)
-        .map((token) => token.trim())
-        .filter((token) => token.length > 0)
-        // Escape pre-existing double quotes per FTS5 phrase syntax (`"` → `""`),
-        // then wrap the whole token in double quotes. The result is always a
-        // valid FTS5 phrase even if the token contained operator-like
-        // punctuation (hyphens, colons, asterisks, parens, etc.).
-        .map((token) => `"${token.replace(/"/g, '""')}"`)
-        .join(' ');
-}
-//# sourceMappingURL=fts5-query-sanitizer.js.map

package/dist/cli/backend/src/services/knowledge/fts5-query-sanitizer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fts5-query-sanitizer.js","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/fts5-query-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;QACV,wEAAwE;QACxE,wEAAwE;SACvE,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACpC,yEAAyE;QACzE,qEAAqE;QACrE,8DAA8D;QAC9D,0DAA0D;SACzD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;SAChD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/cli/backend/src/services/knowledge/fts5-search-strategy.d.ts

@@ -1,56 +0,0 @@
-/**
- * FTS5 Search Strategy
- *
- * Implements the KnowledgeSearchStrategy interface using the SQLite FTS5
- * full-text search index. Maps FTS5 BM25-ranked results to the existing
- * ScoredDocument format used by KnowledgeSearchService.
- *
- * @module services/knowledge/fts5-search-strategy
- */
-import type { KnowledgeSearchStrategy, ScoredDocument } from './knowledge-search.service.js';
-import type { KnowledgeDocumentSummary } from '../../types/knowledge.types.js';
-import { WikiCompilerService } from './wiki-compiler.service.js';
-/**
- * FTS5-based search strategy for the Wiki-First Knowledge System.
- *
- * This strategy provides pure full-text search via SQLite FTS5 with BM25 ranking.
- *
- * Note on semantic fallback (design doc Section 10): The 10% semantic fallback
- * weight is achieved at the MemoryService level, which runs both FTS5 knowledge
- * search AND vector-based semantic search in parallel. This strategy intentionally
- * does not mix semantic results — that composition happens upstream in the recall
- * pipeline (MemoryService.recall -> searchKnowledgeDocuments + semanticSearch).
- *
- * Uses SQLite FTS5 MATCH with BM25 ranking for fast, zero-cost retrieval.
- * Results are mapped back to the KnowledgeDocumentSummary objects provided
- * by the caller, falling back to minimal summaries when a document is found
- * in the FTS5 index but not in the provided documents array.
- *
- * @example
- * ```typescript
- * const strategy = new Fts5SearchStrategy(wikiCompiler);
- * const results = await strategy.search('deployment guide', documents);
- * ```
- */
-export declare class Fts5SearchStrategy implements KnowledgeSearchStrategy {
-    private readonly wikiCompiler;
-    private readonly logger;
-    /**
-     * Create an Fts5SearchStrategy.
-     *
-     * @param wikiCompiler - The WikiCompilerService instance providing FTS5 search
-     */
-    constructor(wikiCompiler: WikiCompilerService);
-    /**
-     * Search for documents matching the query using FTS5 full-text search.
-     *
-     * FTS5 BM25 rank values are negative (more negative = more relevant),
-     * so scores are converted to positive values for the ScoredDocument interface.
-     *
-     * @param query - The search query text
-     * @param documents - Candidate document summaries to match against
-     * @returns Documents sorted by descending relevance score
-     */
-    search(query: string, documents: KnowledgeDocumentSummary[]): Promise<ScoredDocument[]>;
-}
-//# sourceMappingURL=fts5-search-strategy.d.ts.map

package/dist/cli/backend/src/services/knowledge/fts5-search-strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fts5-search-strategy.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/fts5-search-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,YAAW,uBAAuB;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;;;OAIG;gBACS,YAAY,EAAE,mBAAmB;IAK7C;;;;;;;;;OASG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,wBAAwB,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAyC9F"}

package/dist/cli/backend/src/services/knowledge/fts5-search-strategy.js

@@ -1,91 +0,0 @@
-/**
- * FTS5 Search Strategy
- *
- * Implements the KnowledgeSearchStrategy interface using the SQLite FTS5
- * full-text search index. Maps FTS5 BM25-ranked results to the existing
- * ScoredDocument format used by KnowledgeSearchService.
- *
- * @module services/knowledge/fts5-search-strategy
- */
-import { LoggerService } from '../core/logger.service.js';
-/**
- * FTS5-based search strategy for the Wiki-First Knowledge System.
- *
- * This strategy provides pure full-text search via SQLite FTS5 with BM25 ranking.
- *
- * Note on semantic fallback (design doc Section 10): The 10% semantic fallback
- * weight is achieved at the MemoryService level, which runs both FTS5 knowledge
- * search AND vector-based semantic search in parallel. This strategy intentionally
- * does not mix semantic results — that composition happens upstream in the recall
- * pipeline (MemoryService.recall -> searchKnowledgeDocuments + semanticSearch).
- *
- * Uses SQLite FTS5 MATCH with BM25 ranking for fast, zero-cost retrieval.
- * Results are mapped back to the KnowledgeDocumentSummary objects provided
- * by the caller, falling back to minimal summaries when a document is found
- * in the FTS5 index but not in the provided documents array.
- *
- * @example
- * ```typescript
- * const strategy = new Fts5SearchStrategy(wikiCompiler);
- * const results = await strategy.search('deployment guide', documents);
- * ```
- */
-export class Fts5SearchStrategy {
-    wikiCompiler;
-    logger;
-    /**
-     * Create an Fts5SearchStrategy.
-     *
-     * @param wikiCompiler - The WikiCompilerService instance providing FTS5 search
-     */
-    constructor(wikiCompiler) {
-        this.wikiCompiler = wikiCompiler;
-        this.logger = LoggerService.getInstance().createComponentLogger('Fts5SearchStrategy');
-    }
-    /**
-     * Search for documents matching the query using FTS5 full-text search.
-     *
-     * FTS5 BM25 rank values are negative (more negative = more relevant),
-     * so scores are converted to positive values for the ScoredDocument interface.
-     *
-     * @param query - The search query text
-     * @param documents - Candidate document summaries to match against
-     * @returns Documents sorted by descending relevance score
-     */
-    async search(query, documents) {
-        const ftsResults = this.wikiCompiler.search(query, { limit: 10 });
-        if (ftsResults.length === 0) {
-            this.logger.debug('FTS5 search returned no results', { query });
-            return [];
-        }
-        // Build a lookup map from the provided documents array
-        const docById = new Map(documents.map((d) => [d.id, d]));
-        const scored = [];
-        for (const ftsResult of ftsResults) {
-            // FTS5 rank is negative; convert to positive score (higher = more relevant)
-            const score = Math.abs(ftsResult.rank);
-            const existingDoc = docById.get(ftsResult.id);
-            if (existingDoc) {
-                scored.push({ document: existingDoc, score });
-            }
-            else {
-                // Create a minimal summary for documents in FTS5 but not in the provided list
-                const minimalDoc = {
-                    id: ftsResult.id,
-                    title: ftsResult.title,
-                    category: ftsResult.category,
-                    tags: ftsResult.tags ? ftsResult.tags.split(/,\s*/) : [],
-                    preview: ftsResult.content.slice(0, 200),
-                    scope: 'global',
-                    createdBy: 'system',
-                    updatedBy: 'system',
-                    createdAt: new Date().toISOString(),
-                    updatedAt: new Date().toISOString(),
-                };
-                scored.push({ document: minimalDoc, score });
-            }
-        }
-        return scored.sort((a, b) => b.score - a.score);
-    }
-}
-//# sourceMappingURL=fts5-search-strategy.js.map

package/dist/cli/backend/src/services/knowledge/fts5-search-strategy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fts5-search-strategy.js","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/fts5-search-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,kBAAkB;IACZ,YAAY,CAAsB;IAClC,MAAM,CAAkB;IAEzC;;;;OAIG;IACH,YAAY,YAAiC;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,SAAqC;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAElE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uDAAuD;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAqB,EAAE,CAAC;QAEpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,4EAA4E;YAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAE9C,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,8EAA8E;gBAC9E,MAAM,UAAU,GAA6B;oBAC3C,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,QAAQ,EAAE,SAAS,CAAC,QAAQ;oBAC5B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;oBACxD,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACxC,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,QAAQ;oBACnB,SAAS,EAAE,QAAQ;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/cli/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/cli/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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"}