@noyrax/5d-database-plugin 0.1.0

package/out/core/multi-db-manager.js

@@ -0,0 +1,206 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiDbManager = void 0;
+const sqlite3 = __importStar(require("sqlite3"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+const vss_loader_1 = require("./vss-loader");
+const vector_database_factory_1 = require("./vector-database-factory");
+/**
+ * Database file names for each dimension
+ */
+const DIMENSION_DB_FILES = {
+    X: 'modules.db',
+    Y: 'symbols.db',
+    Z: 'dependencies.db',
+    W: 'adrs.db',
+    T: 'changes.db',
+    V: 'vectors.db'
+};
+/**
+ * Manages 5 separate SQLite databases, one for each dimension.
+ * Each database is stored in the workspace-specific .database-plugin directory.
+ */
+class MultiDbManager {
+    /**
+     * Creates a new MultiDbManager instance.
+     * @param workspaceRoot The root directory of the workspace
+     */
+    constructor(workspaceRoot) {
+        this.databases = new Map();
+        this.vectorDatabase = null;
+        this.workspaceRoot = workspaceRoot;
+        this.dbDirectory = path.join(workspaceRoot, '.database-plugin');
+        this.pluginId = this.computePluginId(workspaceRoot);
+        this.vssLoader = new vss_loader_1.VssLoader();
+        this.ensureDbDirectory();
+    }
+    /**
+     * Computes a stable plugin_id from the workspace root path.
+     * Uses SHA256 hash of normalized path, takes first 16 characters.
+     *
+     * @param workspaceRoot The workspace root directory
+     * @returns Stable plugin ID (16 hex characters)
+     */
+    computePluginId(workspaceRoot) {
+        const normalizedPath = path.resolve(workspaceRoot).replace(/\\/g, '/').toLowerCase();
+        const hash = crypto.createHash('sha256').update(normalizedPath).digest('hex');
+        return hash.substring(0, 16);
+    }
+    /**
+     * Ensures the database directory exists.
+     */
+    ensureDbDirectory() {
+        if (!fs.existsSync(this.dbDirectory)) {
+            fs.mkdirSync(this.dbDirectory, { recursive: true });
+        }
+    }
+    /**
+     * Gets the plugin ID for this workspace.
+     */
+    getPluginId() {
+        return this.pluginId;
+    }
+    /**
+     * Gets the database directory path.
+     */
+    getDbDirectory() {
+        return this.dbDirectory;
+    }
+    /**
+     * Opens a database connection for the specified dimension.
+     * If the database is already open, returns the existing connection.
+     * For V-dimension (vectors.db), loads VSS extension before opening.
+     *
+     * @param dimension The dimension (X, Y, Z, W, T, or V)
+     * @returns Promise that resolves to the SQLite database instance
+     */
+    async getDatabase(dimension) {
+        if (this.databases.has(dimension)) {
+            return this.databases.get(dimension);
+        }
+        const dbPath = path.join(this.dbDirectory, DIMENSION_DB_FILES[dimension]);
+        return new Promise((resolve, reject) => {
+            const db = new sqlite3.Database(dbPath, async (err) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                // Initialize vector database for V-dimension
+                if (dimension === 'V') {
+                    try {
+                        await this.vssLoader.loadExtension(db);
+                        // Create vector database instance (VSS on macOS/Linux, ChromaDB on Windows)
+                        if (!this.vectorDatabase) {
+                            this.vectorDatabase = await vector_database_factory_1.VectorDatabaseFactory.create(db, this.vssLoader, this.workspaceRoot);
+                        }
+                    }
+                    catch (vssError) {
+                        // VSS loading failed, but continue without it (will use ChromaDB or fallback)
+                        console.warn(`[MultiDbManager] VSS extension loading failed for V-dimension: ${vssError}`);
+                        // Still create vector database (ChromaDB on Windows, or fallback)
+                        if (!this.vectorDatabase) {
+                            this.vectorDatabase = await vector_database_factory_1.VectorDatabaseFactory.create(db, this.vssLoader, this.workspaceRoot);
+                        }
+                    }
+                }
+                this.databases.set(dimension, db);
+                resolve(db);
+            });
+        });
+    }
+    /**
+     * Closes a database connection for the specified dimension.
+     *
+     * @param dimension The dimension to close
+     * @returns Promise that resolves when the database is closed
+     */
+    async closeDatabase(dimension) {
+        const db = this.databases.get(dimension);
+        if (db) {
+            return new Promise((resolve, reject) => {
+                db.close((err) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        this.databases.delete(dimension);
+                        resolve();
+                    }
+                });
+            });
+        }
+    }
+    /**
+     * Closes all database connections.
+     *
+     * @returns Promise that resolves when all databases are closed
+     */
+    async closeAll() {
+        const closePromises = [];
+        for (const dimension of this.databases.keys()) {
+            closePromises.push(this.closeDatabase(dimension));
+        }
+        await Promise.all(closePromises);
+    }
+    /**
+     * Gets all open database connections.
+     *
+     * @returns Map of dimension to database instance
+     */
+    getOpenDatabases() {
+        return new Map(this.databases);
+    }
+    /**
+     * Gets the Vector Database for vector similarity search.
+     * Only available for V-dimension after initialization.
+     *
+     * @returns Vector Database instance or null if not available
+     */
+    getVectorDatabase() {
+        return this.vectorDatabase;
+    }
+    /**
+     * @deprecated Use getVectorDatabase() instead
+     * Gets the VSS Manager for backward compatibility.
+     */
+    getVssManager() {
+        return this.vectorDatabase;
+    }
+}
+exports.MultiDbManager = MultiDbManager;
+//# sourceMappingURL=multi-db-manager.js.map

package/out/core/multi-db-manager.js.map

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

package/out/core/transaction-manager.d.ts

@@ -0,0 +1,69 @@
+import * as sqlite3 from 'sqlite3';
+import { MultiDbManager, Dimension } from './multi-db-manager';
+/**
+ * Transaction operation that can be executed within a transaction
+ */
+export type TransactionOperation = (db: sqlite3.Database) => Promise<void>;
+/**
+ * Manages transactions across multiple databases (all 5 dimensions).
+ * Ensures atomicity: either all operations succeed or all are rolled back.
+ */
+export declare class TransactionManager {
+    private dbManager;
+    private activeTransactions;
+    /**
+     * Creates a new TransactionManager instance.
+     *
+     * @param dbManager The MultiDbManager instance
+     */
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Begins a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is begun
+     */
+    private beginTransaction;
+    /**
+     * Commits a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is committed
+     */
+    private commitTransaction;
+    /**
+     * Rolls back a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is rolled back
+     */
+    private rollbackTransaction;
+    /**
+     * Executes operations in a transaction across multiple dimensions.
+     * If any operation fails, all transactions are rolled back.
+     *
+     * @param operations Map of dimension to operation function
+     * @returns Promise that resolves when all operations succeed, or rejects if any fail
+     */
+    executeTransaction(operations: Map<Dimension, TransactionOperation>): Promise<void>;
+    /**
+     * Executes operations in a transaction across all dimensions.
+     *
+     * @param operations Map of dimension to operation function
+     * @returns Promise that resolves when all operations succeed
+     */
+    executeTransactionAll(operations: Map<Dimension, TransactionOperation>): Promise<void>;
+    /**
+     * Checks if there are any active transactions.
+     *
+     * @returns True if there are active transactions
+     */
+    hasActiveTransactions(): boolean;
+    /**
+     * Gets the list of dimensions with active transactions.
+     *
+     * @returns Array of dimensions with active transactions
+     */
+    getActiveTransactionDimensions(): Dimension[];
+}
+//# sourceMappingURL=transaction-manager.d.ts.map

package/out/core/transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../../src/core/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,kBAAkB,CAA+C;IAEzE;;;;OAIG;gBACS,SAAS,EAAE,cAAc;IAIrC;;;;;OAKG;YACW,gBAAgB;IAY9B;;;;;OAKG;YACW,iBAAiB;IAY/B;;;;;OAKG;YACW,mBAAmB;IAYjC;;;;;;OAMG;IACU,kBAAkB,CAC3B,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,oBAAoB,CAAC,GACjD,OAAO,CAAC,IAAI,CAAC;IAmChB;;;;;OAKG;IACU,qBAAqB,CAC9B,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,oBAAoB,CAAC,GACjD,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;OAIG;IACI,qBAAqB,IAAI,OAAO;IAIvC;;;;OAIG;IACI,8BAA8B,IAAI,SAAS,EAAE;CAGvD"}

package/out/core/transaction-manager.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionManager = void 0;
+/**
+ * Manages transactions across multiple databases (all 5 dimensions).
+ * Ensures atomicity: either all operations succeed or all are rolled back.
+ */
+class TransactionManager {
+    /**
+     * Creates a new TransactionManager instance.
+     *
+     * @param dbManager The MultiDbManager instance
+     */
+    constructor(dbManager) {
+        this.activeTransactions = new Map();
+        this.dbManager = dbManager;
+    }
+    /**
+     * Begins a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is begun
+     */
+    async beginTransaction(db) {
+        return new Promise((resolve, reject) => {
+            db.run('BEGIN TRANSACTION', (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Commits a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is committed
+     */
+    async commitTransaction(db) {
+        return new Promise((resolve, reject) => {
+            db.run('COMMIT', (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Rolls back a transaction on a database.
+     *
+     * @param db The SQLite database instance
+     * @returns Promise that resolves when the transaction is rolled back
+     */
+    async rollbackTransaction(db) {
+        return new Promise((resolve, reject) => {
+            db.run('ROLLBACK', (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Executes operations in a transaction across multiple dimensions.
+     * If any operation fails, all transactions are rolled back.
+     *
+     * @param operations Map of dimension to operation function
+     * @returns Promise that resolves when all operations succeed, or rejects if any fail
+     */
+    async executeTransaction(operations) {
+        const dimensions = Array.from(operations.keys());
+        const databases = new Map();
+        try {
+            for (const dimension of dimensions) {
+                const db = await this.dbManager.getDatabase(dimension);
+                databases.set(dimension, db);
+                await this.beginTransaction(db);
+                this.activeTransactions.set(dimension, db);
+            }
+            for (const [dimension, operation] of operations.entries()) {
+                const db = databases.get(dimension);
+                await operation(db);
+            }
+            for (const db of databases.values()) {
+                await this.commitTransaction(db);
+            }
+            this.activeTransactions.clear();
+        }
+        catch (error) {
+            for (const db of databases.values()) {
+                try {
+                    await this.rollbackTransaction(db);
+                }
+                catch (rollbackError) {
+                    console.error('Failed to rollback transaction:', rollbackError);
+                }
+            }
+            this.activeTransactions.clear();
+            throw error;
+        }
+    }
+    /**
+     * Executes operations in a transaction across all dimensions.
+     *
+     * @param operations Map of dimension to operation function
+     * @returns Promise that resolves when all operations succeed
+     */
+    async executeTransactionAll(operations) {
+        return this.executeTransaction(operations);
+    }
+    /**
+     * Checks if there are any active transactions.
+     *
+     * @returns True if there are active transactions
+     */
+    hasActiveTransactions() {
+        return this.activeTransactions.size > 0;
+    }
+    /**
+     * Gets the list of dimensions with active transactions.
+     *
+     * @returns Array of dimensions with active transactions
+     */
+    getActiveTransactionDimensions() {
+        return Array.from(this.activeTransactions.keys());
+    }
+}
+exports.TransactionManager = TransactionManager;
+//# sourceMappingURL=transaction-manager.js.map

package/out/core/transaction-manager.js.map

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

package/out/core/vector-database-factory.d.ts

@@ -0,0 +1,25 @@
+import * as sqlite3 from 'sqlite3';
+import { VssLoader } from './vss-loader';
+import { VectorDatabase } from './vector-database-interface';
+/**
+ * Factory for creating vector database instances based on platform.
+ * Selects the appropriate implementation (VSS on macOS/Linux, ChromaDB on Windows).
+ */
+export declare class VectorDatabaseFactory {
+    /**
+     * Creates a vector database instance for the given database.
+     *
+     * @param db The SQLite database instance
+     * @param vssLoader The VSS loader instance
+     * @param workspaceRoot The workspace root directory (for ChromaDB path)
+     * @returns Promise that resolves to a VectorDatabase instance
+     */
+    static create(db: sqlite3.Database, vssLoader: VssLoader, workspaceRoot: string): Promise<VectorDatabase>;
+    /**
+     * Checks if a platform-specific vector database is available.
+     *
+     * @returns true if an optimized vector database is available for the current platform
+     */
+    static isOptimizedDatabaseAvailable(): boolean;
+}
+//# sourceMappingURL=vector-database-factory.d.ts.map

package/out/core/vector-database-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-database-factory.d.ts","sourceRoot":"","sources":["../../src/core/vector-database-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B;;;;;;;OAOG;WACU,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA0C/G;;;;OAIG;IACH,MAAM,CAAC,4BAA4B,IAAI,OAAO;CAoBjD"}

package/out/core/vector-database-factory.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorDatabaseFactory = void 0;
+const vss_vector_database_1 = require("./vss-vector-database");
+const chromadb_vector_database_1 = require("./chromadb-vector-database");
+/**
+ * Factory for creating vector database instances based on platform.
+ * Selects the appropriate implementation (VSS on macOS/Linux, ChromaDB on Windows).
+ */
+class VectorDatabaseFactory {
+    /**
+     * Creates a vector database instance for the given database.
+     *
+     * @param db The SQLite database instance
+     * @param vssLoader The VSS loader instance
+     * @param workspaceRoot The workspace root directory (for ChromaDB path)
+     * @returns Promise that resolves to a VectorDatabase instance
+     */
+    static async create(db, vssLoader, workspaceRoot) {
+        const platform = process.platform;
+        const arch = process.arch;
+        // macOS and Linux: Use VSS
+        if (platform === 'darwin' || platform === 'linux') {
+            const vssDb = new vss_vector_database_1.VssVectorDatabase(db, vssLoader);
+            // Try to initialize VSS
+            try {
+                await vssDb.initialize();
+                if (vssDb.isAvailable()) {
+                    console.log(`[VectorDatabaseFactory] Using VSS Vector Database (${platform}-${arch})`);
+                    return vssDb;
+                }
+            }
+            catch (error) {
+                console.warn(`[VectorDatabaseFactory] VSS initialization failed: ${error}. Will use fallback.`);
+            }
+        }
+        // Windows: Use ChromaDB
+        if (platform === 'win32') {
+            const chromaDb = new chromadb_vector_database_1.ChromaDbVectorDatabase(db, workspaceRoot);
+            try {
+                await chromaDb.initialize();
+                if (chromaDb.isAvailable()) {
+                    console.log(`[VectorDatabaseFactory] Using ChromaDB Vector Database (${platform}-${arch})`);
+                    return chromaDb;
+                }
+            }
+            catch (error) {
+                console.warn(`[VectorDatabaseFactory] ChromaDB initialization failed: ${error}. Will use fallback.`);
+            }
+        }
+        // Fallback: Use VSS (will fallback to cosine similarity if VSS not available)
+        console.warn(`[VectorDatabaseFactory] Optimized vector database not available. Using VSS with fallback to cosine similarity.`);
+        const vssDb = new vss_vector_database_1.VssVectorDatabase(db, vssLoader);
+        await vssDb.initialize(); // Will fail gracefully on Windows
+        return vssDb;
+    }
+    /**
+     * Checks if a platform-specific vector database is available.
+     *
+     * @returns true if an optimized vector database is available for the current platform
+     */
+    static isOptimizedDatabaseAvailable() {
+        const platform = process.platform;
+        // VSS is available on macOS and Linux
+        if (platform === 'darwin' || platform === 'linux') {
+            return true;
+        }
+        // ChromaDB is available on Windows (if installed)
+        if (platform === 'win32') {
+            try {
+                require('chromadb');
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+}
+exports.VectorDatabaseFactory = VectorDatabaseFactory;
+//# sourceMappingURL=vector-database-factory.js.map

package/out/core/vector-database-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-database-factory.js","sourceRoot":"","sources":["../../src/core/vector-database-factory.ts"],"names":[],"mappings":";;;AAGA,+DAA0D;AAC1D,yEAAoE;AAGpE;;;GAGG;AACH,MAAa,qBAAqB;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAoB,EAAE,SAAoB,EAAE,aAAqB;QACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,2BAA2B;QAC3B,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,uCAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YAEnD,wBAAwB;YACxB,IAAI,CAAC;gBACD,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC,sDAAsD,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC;oBACvF,OAAO,KAAK,CAAC;gBACjB,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,sDAAsD,KAAK,sBAAsB,CAAC,CAAC;YACpG,CAAC;QACL,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,iDAAsB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAE/D,IAAI,CAAC;gBACD,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAC5B,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzB,OAAO,CAAC,GAAG,CAAC,2DAA2D,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC;oBAC5F,OAAO,QAAQ,CAAC;gBACpB,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,2DAA2D,KAAK,sBAAsB,CAAC,CAAC;YACzG,CAAC;QACL,CAAC;QAED,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,gHAAgH,CAAC,CAAC;QAC/H,MAAM,KAAK,GAAG,IAAI,uCAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,kCAAkC;QAC5D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,4BAA4B;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAElC,sCAAsC;QACtC,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,kDAAkD;QAClD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,OAAO,CAAC,UAAU,CAAC,CAAC;gBACpB,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AA5ED,sDA4EC"}

package/out/core/vector-database-interface.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Interface for vector database operations.
+ * Abstracts VSS and external vector databases (e.g., ChromaDB).
+ */
+export interface VectorDatabase {
+    /**
+     * Checks if the vector database is available and ready to use.
+     *
+     * @returns true if available, false otherwise
+     */
+    isAvailable(): boolean;
+    /**
+     * Initializes the vector database.
+     * Must be called before using other methods.
+     *
+     * @returns Promise that resolves when initialization is complete
+     */
+    initialize(): Promise<void>;
+    /**
+     * Upserts (inserts or updates) an embedding vector.
+     *
+     * @param embeddingId The unique identifier for the embedding
+     * @param embeddingVector The embedding vector (1536 dimensions)
+     * @returns Promise that resolves when the embedding is upserted
+     */
+    upsertEmbedding(embeddingId: string, embeddingVector: Float32Array | number[]): Promise<void>;
+    /**
+     * Searches for similar embeddings using vector similarity search.
+     *
+     * @param queryEmbedding The query embedding vector
+     * @param limit Maximum number of results to return
+     * @param dimension Optional: Filter by dimension (X, Y, Z, W, T)
+     * @param pluginId Optional: Filter by plugin ID
+     * @returns Promise that resolves to an array of search results with rowid and distance/similarity score
+     */
+    search(queryEmbedding: Float32Array | number[], limit: number, dimension?: 'X' | 'Y' | 'Z' | 'W' | 'T', pluginId?: string): Promise<Array<{
+        rowid: number;
+        distance: number;
+        similarity?: number;
+    }>>;
+    /**
+     * Gets the embedding ID from a rowid.
+     * This is needed for mapping VSS rowids back to embedding IDs.
+     *
+     * @param rowid The rowid from the search result
+     * @returns Promise that resolves to the embedding ID, or null if not found
+     */
+    getEmbeddingIdFromRowid(rowid: number): Promise<string | null>;
+}
+//# sourceMappingURL=vector-database-interface.d.ts.map

package/out/core/vector-database-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-database-interface.d.ts","sourceRoot":"","sources":["../../src/core/vector-database-interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F;;;;;;;;OAQG;IACH,MAAM,CACF,cAAc,EAAE,YAAY,GAAG,MAAM,EAAE,EACvC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EACvC,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClE"}

package/out/core/vector-database-interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vector-database-interface.js.map

package/out/core/vector-database-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-database-interface.js","sourceRoot":"","sources":["../../src/core/vector-database-interface.ts"],"names":[],"mappings":""}

package/out/core/vss-loader.d.ts

@@ -0,0 +1,29 @@
+import * as sqlite3 from 'sqlite3';
+/**
+ * Loads SQLite VSS Extension for vector similarity search.
+ * Uses sqlite-vss package if available, otherwise falls back to manual path resolution.
+ */
+export declare class VssLoader {
+    /**
+     * Loads the VSS extension into the given database.
+     *
+     * @param db The SQLite database instance
+     */
+    loadExtension(db: sqlite3.Database): Promise<void>;
+    /**
+     * Gets the path to the VSS extension binary for the current platform.
+     * Fallback method if sqlite-vss package is not available.
+     *
+     * @param platform The platform (win32, linux, darwin)
+     * @param arch The architecture (x64, arm64, etc.)
+     * @returns Path to the VSS extension binary
+     */
+    private getVssPath;
+    /**
+     * Checks if VSS extension is available.
+     *
+     * @returns true if VSS extension is available, false otherwise
+     */
+    isAvailable(): boolean;
+}
+//# sourceMappingURL=vss-loader.d.ts.map

package/out/core/vss-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vss-loader.d.ts","sourceRoot":"","sources":["../../src/core/vss-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAYnC;;;GAGG;AACH,qBAAa,SAAS;IAClB;;;;OAIG;IACG,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxD;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;;OAIG;IACH,WAAW,IAAI,OAAO;CAmBzB"}