@noyrax/5d-database-plugin 0.1.0

package/out/api/search-api.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchApi = void 0;
+const module_api_1 = require("./module-api");
+const symbol_api_1 = require("./symbol-api");
+const adr_api_1 = require("./adr-api");
+const dependency_api_1 = require("./dependency-api");
+const change_api_1 = require("./change-api");
+/**
+ * API for keyword search across all 5 dimensions.
+ */
+class SearchApi {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+        this.moduleApi = new module_api_1.ModuleApi(dbManager);
+        this.symbolApi = new symbol_api_1.SymbolApi(dbManager);
+        this.adrApi = new adr_api_1.AdrApi(dbManager);
+        this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
+        this.changeApi = new change_api_1.ChangeApi(dbManager);
+    }
+    /**
+     * Searches across all dimensions.
+     */
+    async searchAll(query, pluginId, options = {}) {
+        const limit = options.limit || 20;
+        const caseSensitive = options.caseSensitive || false;
+        const results = [];
+        // Search in parallel across all dimensions
+        const [modules, symbols, adrs, dependencies, changes] = await Promise.all([
+            this.searchModules(query, pluginId, limit, caseSensitive),
+            this.searchSymbols(query, pluginId, limit, caseSensitive),
+            this.searchAdrs(query, pluginId, limit, caseSensitive),
+            this.searchDependencies(query, pluginId, limit, caseSensitive),
+            this.searchChanges(query, pluginId, limit, caseSensitive)
+        ]);
+        results.push(...modules, ...symbols, ...adrs, ...dependencies, ...changes);
+        // Sort by relevance (exact matches first, then by dimension)
+        return this.sortByRelevance(results, query);
+    }
+    /**
+     * Searches in X-Dimension (Modules).
+     */
+    async searchModules(query, pluginId, limit, caseSensitive) {
+        const db = await this.dbManager.getDatabase('X');
+        const searchPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const exactPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const rows = await this.queryDatabase(db, `SELECT * FROM modules 
+             WHERE plugin_id = ? 
+             AND deleted_at IS NULL
+             AND (
+                 ${caseSensitive ? 'file_path LIKE ?' : 'LOWER(file_path) LIKE ?'}
+                 OR ${caseSensitive ? 'content_markdown LIKE ?' : 'LOWER(content_markdown) LIKE ?'}
+             )
+             ORDER BY 
+                 CASE WHEN ${caseSensitive ? 'file_path' : 'LOWER(file_path)'} LIKE ? THEN 1 ELSE 2 END,
+                 file_path
+             LIMIT ?`, caseSensitive
+            ? [pluginId, searchPattern, searchPattern, exactPattern, limit]
+            : [pluginId, searchPattern, searchPattern, exactPattern, limit]);
+        return rows.map((row) => ({
+            dimension: 'X',
+            id: row.id,
+            label: row.file_path,
+            description: `Module: ${row.file_path}`,
+            filePath: row.file_path,
+            metadata: {
+                contentHash: row.content_hash,
+                createdAt: row.created_at
+            }
+        }));
+    }
+    /**
+     * Searches in Y-Dimension (Symbols).
+     */
+    async searchSymbols(query, pluginId, limit, caseSensitive) {
+        const db = await this.dbManager.getDatabase('Y');
+        const searchPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const exactPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const rows = await this.queryDatabase(db, `SELECT * FROM symbols 
+             WHERE plugin_id = ? 
+             AND deleted_at IS NULL
+             AND (
+                 ${caseSensitive ? 'name LIKE ?' : 'LOWER(name) LIKE ?'}
+                 OR ${caseSensitive ? 'path LIKE ?' : 'LOWER(path) LIKE ?'}
+                 OR (summary IS NOT NULL AND ${caseSensitive ? 'summary LIKE ?' : 'LOWER(summary) LIKE ?'})
+             )
+             ORDER BY 
+                 CASE WHEN ${caseSensitive ? 'name' : 'LOWER(name)'} LIKE ? THEN 1 ELSE 2 END,
+                 name
+             LIMIT ?`, caseSensitive
+            ? [pluginId, searchPattern, searchPattern, searchPattern, exactPattern, limit]
+            : [pluginId, searchPattern, searchPattern, searchPattern, exactPattern, limit]);
+        return rows.map((row) => ({
+            dimension: 'Y',
+            id: row.symbol_id,
+            label: `${row.name} (${row.kind})`,
+            description: `Symbol in ${row.path}`,
+            filePath: row.path,
+            metadata: {
+                kind: row.kind,
+                symbolId: row.symbol_id
+            }
+        }));
+    }
+    /**
+     * Searches in W-Dimension (ADRs).
+     */
+    async searchAdrs(query, pluginId, limit, caseSensitive) {
+        const db = await this.dbManager.getDatabase('W');
+        const searchPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const exactPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const rows = await this.queryDatabase(db, `SELECT * FROM adrs 
+             WHERE plugin_id = ? 
+             AND deleted_at IS NULL
+             AND (
+                 ${caseSensitive ? 'title LIKE ?' : 'LOWER(title) LIKE ?'}
+                 OR ${caseSensitive ? 'adr_number LIKE ?' : 'LOWER(adr_number) LIKE ?'}
+                 OR ${caseSensitive ? 'content_markdown LIKE ?' : 'LOWER(content_markdown) LIKE ?'}
+             )
+             ORDER BY 
+                 CASE WHEN ${caseSensitive ? 'title' : 'LOWER(title)'} LIKE ? THEN 1 ELSE 2 END,
+                 adr_number
+             LIMIT ?`, caseSensitive
+            ? [pluginId, searchPattern, searchPattern, searchPattern, exactPattern, limit]
+            : [pluginId, searchPattern, searchPattern, searchPattern, exactPattern, limit]);
+        return rows.map((row) => ({
+            dimension: 'W',
+            id: row.adr_number,
+            label: `ADR-${row.adr_number}: ${row.title}`,
+            description: `Architecture Decision Record`,
+            metadata: {
+                fileName: row.file_name,
+                adrNumber: row.adr_number
+            }
+        }));
+    }
+    /**
+     * Searches in Z-Dimension (Dependencies).
+     */
+    async searchDependencies(query, pluginId, limit, caseSensitive) {
+        const db = await this.dbManager.getDatabase('Z');
+        const searchPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const exactPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const rows = await this.queryDatabase(db, `SELECT * FROM dependencies 
+             WHERE plugin_id = ? 
+             AND (
+                 ${caseSensitive ? 'from_module LIKE ?' : 'LOWER(from_module) LIKE ?'}
+                 OR ${caseSensitive ? 'to_module LIKE ?' : 'LOWER(to_module) LIKE ?'}
+             )
+             ORDER BY 
+                 CASE WHEN ${caseSensitive ? 'from_module' : 'LOWER(from_module)'} LIKE ? THEN 1 ELSE 2 END,
+                 from_module, to_module
+             LIMIT ?`, caseSensitive
+            ? [pluginId, searchPattern, searchPattern, exactPattern, limit]
+            : [pluginId, searchPattern, searchPattern, exactPattern, limit]);
+        return rows.map((row) => ({
+            dimension: 'Z',
+            id: row.id,
+            label: `${row.from_module} → ${row.to_module}`,
+            description: `Dependency: ${row.dependency_type}`,
+            metadata: {
+                dependencyType: row.dependency_type,
+                fromModule: row.from_module,
+                toModule: row.to_module
+            }
+        }));
+    }
+    /**
+     * Searches in T-Dimension (Changes).
+     */
+    async searchChanges(query, pluginId, limit, caseSensitive) {
+        const db = await this.dbManager.getDatabase('T');
+        // Changes are searched by date or run type
+        const searchPattern = caseSensitive ? `%${query}%` : `%${query.toLowerCase()}%`;
+        const rows = await this.queryDatabase(db, `SELECT * FROM change_reports 
+             WHERE plugin_id = ? 
+             AND (
+                 ${caseSensitive ? 'run_type LIKE ?' : 'LOWER(run_type) LIKE ?'}
+                 OR CAST(created_at AS TEXT) LIKE ?
+             )
+             ORDER BY created_at DESC
+             LIMIT ?`, [pluginId, searchPattern, searchPattern, limit]);
+        return rows.map((row) => ({
+            dimension: 'T',
+            id: row.id,
+            label: `${row.run_type} - ${new Date(row.created_at).toLocaleDateString()}`,
+            description: `${row.parsed_files} files, ${row.total_dependencies} deps`,
+            metadata: {
+                runType: row.run_type,
+                parsedFiles: row.parsed_files.toString(),
+                totalDependencies: row.total_dependencies.toString()
+            }
+        }));
+    }
+    /**
+     * Helper method to query database directly.
+     */
+    async queryDatabase(db, sql, params) {
+        return new Promise((resolve, reject) => {
+            db.all(sql, params, (err, rows) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(rows || []);
+                }
+            });
+        });
+    }
+    /**
+     * Sorts results by relevance (exact matches first, then by dimension order).
+     */
+    sortByRelevance(results, query) {
+        const queryLower = query.toLowerCase();
+        return results.sort((a, b) => {
+            // Exact match in label gets highest priority
+            const aExact = a.label.toLowerCase().includes(queryLower);
+            const bExact = b.label.toLowerCase().includes(queryLower);
+            if (aExact && !bExact)
+                return -1;
+            if (!aExact && bExact)
+                return 1;
+            // Then sort by dimension order: X, Y, Z, W, T
+            const dimensionOrder = { X: 1, Y: 2, Z: 3, W: 4, T: 5 };
+            const aOrder = dimensionOrder[a.dimension] || 99;
+            const bOrder = dimensionOrder[b.dimension] || 99;
+            if (aOrder !== bOrder)
+                return aOrder - bOrder;
+            // Finally sort alphabetically by label
+            return a.label.localeCompare(b.label);
+        });
+    }
+}
+exports.SearchApi = SearchApi;
+//# sourceMappingURL=search-api.js.map

package/out/api/search-api.js.map

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

package/out/api/self-explanation-api.d.ts

@@ -0,0 +1,71 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { EntityReference } from '../models/entity-reference';
+/**
+ * System explanation interface.
+ * Describes what the system is, how it works, and entry points.
+ */
+export interface SystemExplanation {
+    what_am_i: string;
+    how_do_i_work: string;
+    dimensions: Array<{
+        id: 'X' | 'Y' | 'Z' | 'W' | 'T';
+        name: string;
+        description: string;
+        entity_count?: number;
+    }>;
+    entry_points: Array<EntityReference & {
+        reason?: string;
+    }>;
+    architecture_adrs: Array<{
+        adr_number: string;
+        title: string;
+    }>;
+    suggested_start: string;
+}
+/**
+ * System overview interface.
+ */
+export interface SystemOverview {
+    total_modules: number;
+    total_symbols: number;
+    total_dependencies: number;
+    total_adrs: number;
+    total_change_reports: number;
+    entry_points: Array<EntityReference & {
+        reason?: string;
+    }>;
+    architecture_adrs: Array<{
+        adr_number: string;
+        title: string;
+    }>;
+}
+/**
+ * API for system self-explanation.
+ * Provides meta-information about the system WITHOUT AI generation.
+ */
+export declare class SelfExplanationApi {
+    private dbManager;
+    private adrApi;
+    private moduleApi;
+    private symbolApi;
+    private dependencyApi;
+    private changeApi;
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Gets system overview with statistics and entry points.
+     */
+    getSystemOverview(pluginId: string): Promise<SystemOverview>;
+    /**
+     * Explains the system: what it is, how it works, entry points, and architecture ADRs.
+     */
+    explainSystem(pluginId: string): Promise<SystemExplanation>;
+    /**
+     * Gets entry points for the system.
+     */
+    private getEntryPoints;
+    /**
+     * Gets architecture ADRs (typically ADR-001, ADR-002, etc.).
+     */
+    private getArchitectureAdrs;
+}
+//# sourceMappingURL=self-explanation-api.d.ts.map

package/out/api/self-explanation-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-explanation-api.d.ts","sourceRoot":"","sources":["../../src/api/self-explanation-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,cAAc;IASrC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyBlE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8DjE;;OAEG;YACW,cAAc;IAsB5B;;OAEG;YACW,mBAAmB;CAsBpC"}

package/out/api/self-explanation-api.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelfExplanationApi = void 0;
+const navigation_repository_1 = require("../repositories/navigation-repository");
+const adr_api_1 = require("./adr-api");
+const module_api_1 = require("./module-api");
+const symbol_api_1 = require("./symbol-api");
+const dependency_api_1 = require("./dependency-api");
+const change_api_1 = require("./change-api");
+/**
+ * API for system self-explanation.
+ * Provides meta-information about the system WITHOUT AI generation.
+ */
+class SelfExplanationApi {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+        this.adrApi = new adr_api_1.AdrApi(dbManager);
+        this.moduleApi = new module_api_1.ModuleApi(dbManager);
+        this.symbolApi = new symbol_api_1.SymbolApi(dbManager);
+        this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
+        this.changeApi = new change_api_1.ChangeApi(dbManager);
+    }
+    /**
+     * Gets system overview with statistics and entry points.
+     */
+    async getSystemOverview(pluginId) {
+        // Get statistics
+        const modules = await this.moduleApi.getAllModules(pluginId);
+        const symbols = await this.symbolApi.getAllSymbols(pluginId);
+        const dependencies = await this.dependencyApi.getAllDependencies(pluginId);
+        const adrs = await this.adrApi.getAllAdrs(pluginId);
+        const changeReports = await this.changeApi.getAllChangeReports(pluginId);
+        // Get entry points
+        const entryPoints = await this.getEntryPoints(pluginId);
+        // Get architecture ADRs
+        const architectureAdrs = await this.getArchitectureAdrs(pluginId);
+        return {
+            total_modules: modules.length,
+            total_symbols: symbols.length,
+            total_dependencies: dependencies.length,
+            total_adrs: adrs.length,
+            total_change_reports: changeReports.length,
+            entry_points: entryPoints,
+            architecture_adrs: architectureAdrs
+        };
+    }
+    /**
+     * Explains the system: what it is, how it works, entry points, and architecture ADRs.
+     */
+    async explainSystem(pluginId) {
+        // Get entry points
+        const entryPoints = await this.getEntryPoints(pluginId);
+        // Get architecture ADRs
+        const architectureAdrs = await this.getArchitectureAdrs(pluginId);
+        // Get dimension statistics
+        const modules = await this.moduleApi.getAllModules(pluginId);
+        const symbols = await this.symbolApi.getAllSymbols(pluginId);
+        const dependencies = await this.dependencyApi.getAllDependencies(pluginId);
+        const adrs = await this.adrApi.getAllAdrs(pluginId);
+        const changeReports = await this.changeApi.getAllChangeReports(pluginId);
+        // Determine suggested start
+        let suggestedStart = 'Start with MultiDbManager (core module)';
+        if (architectureAdrs.length > 0) {
+            const firstAdr = architectureAdrs[0];
+            suggestedStart = `Start with ${firstAdr.adr_number} (${firstAdr.title})`;
+        }
+        return {
+            what_am_i: '5D Database Plugin - navigable code documentation system',
+            how_do_i_work: '5 dimensions (X,Y,Z,W,T) store different views of code: Modules (X), Symbols (Y), Dependencies (Z), ADRs (W), and Changes (T). Each dimension provides a different perspective on the codebase, enabling cross-dimensional navigation and analysis.',
+            dimensions: [
+                {
+                    id: 'X',
+                    name: 'Modules',
+                    description: 'API documentation per file',
+                    entity_count: modules.length
+                },
+                {
+                    id: 'Y',
+                    name: 'Symbols',
+                    description: 'Symbols with dependencies',
+                    entity_count: symbols.length
+                },
+                {
+                    id: 'Z',
+                    name: 'Dependencies',
+                    description: 'Module dependencies',
+                    entity_count: dependencies.length
+                },
+                {
+                    id: 'W',
+                    name: 'ADRs',
+                    description: 'Architecture decisions',
+                    entity_count: adrs.length
+                },
+                {
+                    id: 'T',
+                    name: 'Changes',
+                    description: 'Change history',
+                    entity_count: changeReports.length
+                }
+            ],
+            entry_points: entryPoints,
+            architecture_adrs: architectureAdrs,
+            suggested_start: suggestedStart
+        };
+    }
+    /**
+     * Gets entry points for the system.
+     */
+    async getEntryPoints(pluginId) {
+        const db = await this.dbManager.getDatabase('V');
+        const navRepo = new navigation_repository_1.NavigationRepository(db);
+        const entryPoints = await navRepo.getEntryPoints('X', pluginId);
+        const result = [];
+        for (const ep of entryPoints) {
+            const module = await this.moduleApi.getModuleById(ep.entity_id, pluginId);
+            if (module) {
+                result.push({
+                    dimension: 'X',
+                    entity_id: ep.entity_id,
+                    external_id: module.file_path,
+                    reason: ep.importance_rank ? `Entry point (rank ${ep.importance_rank})` : 'Entry point'
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Gets architecture ADRs (typically ADR-001, ADR-002, etc.).
+     */
+    async getArchitectureAdrs(pluginId) {
+        const allAdrs = await this.adrApi.getAllAdrs(pluginId);
+        // Filter for architecture ADRs (typically low-numbered ADRs)
+        // ADRs with numbers like "001", "002", "003" are usually architecture ADRs
+        const architectureAdrs = allAdrs
+            .filter(adr => {
+            const num = parseInt(adr.adr_number);
+            return !isNaN(num) && num <= 10; // First 10 ADRs are usually architecture
+        })
+            .sort((a, b) => {
+            const numA = parseInt(a.adr_number);
+            const numB = parseInt(b.adr_number);
+            return numA - numB;
+        })
+            .map(adr => ({
+            adr_number: adr.adr_number,
+            title: adr.title
+        }));
+        return architectureAdrs;
+    }
+}
+exports.SelfExplanationApi = SelfExplanationApi;
+//# sourceMappingURL=self-explanation-api.js.map

package/out/api/self-explanation-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-explanation-api.js","sourceRoot":"","sources":["../../src/api/self-explanation-api.ts"],"names":[],"mappings":"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"}

package/out/api/semantic-search-api.d.ts

@@ -0,0 +1,64 @@
+import { MultiDbManager } from '../core/multi-db-manager';
+import { EmbeddingGenerator } from '../embedding/embedding-generator';
+import { EntityReference } from '../models/entity-reference';
+/**
+ * Semantic search result
+ */
+export interface SemanticSearchResult {
+    dimension: 'X' | 'Y' | 'Z' | 'W' | 'T';
+    entityId: string;
+    externalId: string;
+    score: number;
+    vectorScore: number;
+    importanceScore: number;
+    entityRef: EntityReference;
+}
+/**
+ * Options for semantic search
+ */
+export interface SemanticSearchOptions {
+    dimensions?: ('X' | 'Y' | 'Z' | 'W' | 'T')[];
+    limit?: number;
+    minScore?: number;
+}
+/**
+ * API for semantic search over all dimensions using vector similarity.
+ */
+export declare class SemanticSearchApi {
+    private dbManager;
+    private embeddingGenerator;
+    private readonly vectorWeight;
+    private readonly importanceWeight;
+    constructor(dbManager: MultiDbManager, embeddingGenerator: EmbeddingGenerator);
+    /**
+     * Performs semantic search across all or specified dimensions.
+     *
+     * @param query Natural language query
+     * @param pluginId Plugin ID
+     * @param options Search options
+     * @returns Promise that resolves to search results sorted by relevance
+     */
+    search(query: string, pluginId: string, options?: SemanticSearchOptions): Promise<SemanticSearchResult[]>;
+    /**
+     * Searches in a specific dimension using vector similarity.
+     * Uses VSS if available, otherwise falls back to cosine similarity.
+     */
+    private searchDimension;
+    /**
+     * Searches using vector database (VSS or external DB).
+     */
+    private searchWithVectorDatabase;
+    /**
+     * Gets embedding by rowid.
+     */
+    private getEmbeddingByRowid;
+    /**
+     * Searches using manual cosine similarity (fallback).
+     */
+    private searchWithCosineSimilarity;
+    /**
+     * Calculates cosine similarity between two vectors.
+     */
+    private cosineSimilarity;
+}
+//# sourceMappingURL=semantic-search-api.d.ts.map

package/out/api/semantic-search-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search-api.d.ts","sourceRoot":"","sources":["../../src/api/semantic-search-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAEpC,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB;IAK7E;;;;;;;OAOG;IACG,MAAM,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAsClC;;;OAGG;YACW,eAAe;IA2C7B;;OAEG;YACW,wBAAwB;IAsEtC;;OAEG;YACW,mBAAmB;IAoBjC;;OAEG;YACW,0BAA0B;IA+DxC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAsB3B"}