@slorenzot/memento-core 0.7.0 → 2.0.0

package/dist/ConfigManager.js

@@ -1,20 +1,65 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_CONFIG_FILE = exports.NEW_CONFIG_FILE = exports.NEW_CONFIG_DIR = exports.GLOBAL_CONFIG_PATH = exports.GLOBAL_CONFIG_DIR = exports.DEFAULT_STALE_THRESHOLD_MS = void 0;
+exports.normalizeProjectId = normalizeProjectId;
 exports.findProjectConfig = findProjectConfig;
+exports.findConfigPath = findConfigPath;
+exports.getStaleThresholdMs = getStaleThresholdMs;
 exports.loadConfig = loadConfig;
 exports.resolveStoragePath = resolveStoragePath;
 exports.resolveDbPath = resolveDbPath;
 exports.getProjectId = getProjectId;
+exports.createConfig = createConfig;
+exports.migrateConfig = migrateConfig;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = require("os");
+/** Default stale threshold: 24 hours in milliseconds */
+exports.DEFAULT_STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000;
+// ─── Constants ──────────────────────────────────────────────
 const DEFAULT_CONFIG = {
     storageMethod: 'database',
     dbPath: '.memento/db/memento.db',
     storagePath: 'database/storage',
 };
-const GLOBAL_CONFIG_PATH = (0, path_1.join)((0, os_1.homedir)(), '.memento', 'config');
-const LOCAL_CONFIG_FILE = '.mementorc';
+const LEGACY_CONFIG_FILE = '.mementorc';
+exports.LEGACY_CONFIG_FILE = LEGACY_CONFIG_FILE;
+const NEW_CONFIG_DIR = '.memento';
+exports.NEW_CONFIG_DIR = NEW_CONFIG_DIR;
+const NEW_CONFIG_FILE = 'config.json';
+exports.NEW_CONFIG_FILE = NEW_CONFIG_FILE;
+const GLOBAL_CONFIG_DIR = (0, path_1.join)((0, os_1.homedir)(), '.memento');
+exports.GLOBAL_CONFIG_DIR = GLOBAL_CONFIG_DIR;
+const GLOBAL_CONFIG_FILE = 'config.json';
+const GLOBAL_CONFIG_PATH = (0, path_1.join)(GLOBAL_CONFIG_DIR, GLOBAL_CONFIG_FILE);
+exports.GLOBAL_CONFIG_PATH = GLOBAL_CONFIG_PATH;
+// ─── Project ID Normalization ──────────────────────────────
+/**
+ * Normalize a project identifier to a canonical form.
+ * - Lowercase
+ * - Replace spaces, underscores, and special chars with hyphens
+ * - Collapse multiple consecutive hyphens into one
+ * - Strip leading/trailing hyphens
+ *
+ * Examples:
+ *   "sura chile autos"           → "sura-chile-autos"
+ *   "suratech-salesforce-CL-app" → "suratech-salesforce-cl-app"
+ *   "my__cool  project"          → "my-cool-project"
+ *   "--leading-trailing--"       → "leading-trailing"
+ *   "  spaces  everywhere  "     → "spaces-everywhere"
+ */
+function normalizeProjectId(name) {
+    if (!name || typeof name !== 'string') {
+        return 'default';
+    }
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-') // replace non-alphanumeric sequences with single hyphen
+        .replace(/^-+|-+$/g, '') // strip leading/trailing hyphens
+        || 'default'; // fallback if result is empty
+}
+// ─── Internal Helpers ───────────────────────────────────────
 function loadJSONFile(path) {
     if (!(0, fs_1.existsSync)(path)) {
         return null;
@@ -27,14 +72,46 @@ function loadJSONFile(path) {
         return null;
     }
 }
+function isConfigV1(config) {
+    return (typeof config === 'object' &&
+        config !== null &&
+        config.version === 1 &&
+        typeof config.project === 'string' &&
+        typeof config.database?.path === 'string');
+}
+function deriveProjectName(dir) {
+    // Try package.json first
+    const packageJsonPath = (0, path_1.join)(dir, 'package.json');
+    const packageJson = loadJSONFile(packageJsonPath);
+    if (packageJson?.name) {
+        // Strip @scope/ prefix
+        return packageJson.name.replace(/^@[^/]+\//, '');
+    }
+    // Fall back to directory name
+    return (0, path_1.basename)(dir);
+}
+// ─── Config Discovery ──────────────────────────────────────
+/**
+ * Find project config searching upward from startDir.
+ * Priority: .memento/config.json → .mementorc (legacy)
+ */
 function findProjectConfig(startDir = process.cwd()) {
     let currentDir = startDir;
     const maxDepth = 10;
     let depth = 0;
     while (depth < maxDepth) {
-        const configPath = (0, path_1.join)(currentDir, LOCAL_CONFIG_FILE);
-        if ((0, fs_1.existsSync)(configPath)) {
-            const config = loadJSONFile(configPath);
+        // New format first: .memento/config.json
+        const newConfigPath = (0, path_1.join)(currentDir, NEW_CONFIG_DIR, NEW_CONFIG_FILE);
+        if ((0, fs_1.existsSync)(newConfigPath)) {
+            const config = loadJSONFile(newConfigPath);
+            if (isConfigV1(config)) {
+                return configV1ToLegacy(config, currentDir);
+            }
+        }
+        // Legacy format: .mementorc
+        const legacyConfigPath = (0, path_1.join)(currentDir, LEGACY_CONFIG_FILE);
+        if ((0, fs_1.existsSync)(legacyConfigPath)) {
+            const config = loadJSONFile(legacyConfigPath);
             if (config) {
                 return config;
             }
@@ -48,6 +125,47 @@ function findProjectConfig(startDir = process.cwd()) {
     }
     return null;
 }
+/**
+ * Find the raw config path (new or legacy format).
+ * Returns the absolute path to the config file found.
+ */
+function findConfigPath(startDir = process.cwd()) {
+    let currentDir = startDir;
+    const maxDepth = 10;
+    let depth = 0;
+    while (depth < maxDepth) {
+        const newConfigPath = (0, path_1.join)(currentDir, NEW_CONFIG_DIR, NEW_CONFIG_FILE);
+        if ((0, fs_1.existsSync)(newConfigPath))
+            return newConfigPath;
+        const legacyConfigPath = (0, path_1.join)(currentDir, LEGACY_CONFIG_FILE);
+        if ((0, fs_1.existsSync)(legacyConfigPath))
+            return legacyConfigPath;
+        const parentDir = (0, path_1.dirname)(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+        depth++;
+    }
+    return null;
+}
+// ─── Config Loading ─────────────────────────────────────────
+/**
+ * Read the stale session threshold from V1 config.
+ * Returns DEFAULT_STALE_THRESHOLD_MS (24h) if not configured.
+ */
+function getStaleThresholdMs() {
+    const configPath = findConfigPath();
+    if (!configPath)
+        return exports.DEFAULT_STALE_THRESHOLD_MS;
+    // Only V1 config supports this setting
+    if (configPath.endsWith('config.json')) {
+        const v1 = loadJSONFile(configPath);
+        if (v1?.defaults?.session?.staleThresholdMs) {
+            return v1.defaults.session.staleThresholdMs;
+        }
+    }
+    return exports.DEFAULT_STALE_THRESHOLD_MS;
+}
 function loadConfig() {
     let config = { ...DEFAULT_CONFIG };
     const projectConfig = findProjectConfig();
@@ -58,6 +176,7 @@ function loadConfig() {
     if (globalConfig) {
         config = { ...config, ...globalConfig };
     }
+    // Environment variable overrides
     if (process.env.MEMENTO_STORAGE_METHOD) {
         config.storageMethod = process.env.MEMENTO_STORAGE_METHOD;
     }
@@ -72,6 +191,7 @@ function loadConfig() {
     }
     return config;
 }
+// ─── Path Resolution ────────────────────────────────────────
 function resolveStoragePath(config) {
     const storagePath = config.storagePath || DEFAULT_CONFIG.storagePath;
     if (storagePath.startsWith('/')) {
@@ -94,10 +214,146 @@ function resolveDbPath(config) {
 }
 function getProjectId(config) {
     if (config.projectId) {
-        return config.projectId;
+        return normalizeProjectId(config.projectId);
     }
     const packageJsonPath = (0, path_1.join)(process.cwd(), 'package.json');
     const packageJson = loadJSONFile(packageJsonPath);
-    return packageJson?.name || 'default';
+    const rawName = packageJson?.name || 'default';
+    // Strip @scope/ prefix before normalizing (consistent with deriveProjectName)
+    return normalizeProjectId(rawName.replace(/^@[^/]+\//, ''));
+}
+// ─── Config V1 ↔ Legacy Conversion ─────────────────────────
+function configV1ToLegacy(v1, _configDir) {
+    return {
+        storageMethod: 'database',
+        dbPath: v1.database.path,
+        projectId: v1.project,
+    };
+}
+function legacyToConfigV1(legacy, projectDir) {
+    return {
+        version: 1,
+        project: legacy.projectId || deriveProjectName(projectDir),
+        database: {
+            path: legacy.dbPath || (0, path_1.join)('.memento', 'memento.db'),
+            wal: true,
+        },
+        defaults: {
+            autoSeed: true,
+            scope: 'project',
+        },
+    };
+}
+// ─── Config Creation ────────────────────────────────────────
+/**
+ * Create a new config file (.memento/config.json or global).
+ * Returns the result with paths and whether migration occurred.
+ */
+function createConfig(options = {}) {
+    const { project, dbPath, targetDir, force = false, global = false, } = options;
+    const resolvedDir = global
+        ? GLOBAL_CONFIG_DIR
+        : (targetDir || process.cwd());
+    const configDir = global
+        ? GLOBAL_CONFIG_DIR
+        : (0, path_1.join)(resolvedDir, NEW_CONFIG_DIR);
+    const configPath = (0, path_1.join)(configDir, NEW_CONFIG_FILE);
+    // Check existing config
+    if (!force && (0, fs_1.existsSync)(configPath)) {
+        throw new Error(`Config already exists at ${configPath}. Use --force to overwrite.`);
+    }
+    // Check for legacy config to migrate
+    let migrated = false;
+    let backupPath;
+    const legacyPath = (0, path_1.join)(resolvedDir, LEGACY_CONFIG_FILE);
+    let projectName = project || deriveProjectName(resolvedDir);
+    let resolvedDbPath = dbPath || (0, path_1.join)(NEW_CONFIG_DIR, 'memento.db');
+    // If migrating from legacy config
+    if (!global && (0, fs_1.existsSync)(legacyPath)) {
+        const legacyConfig = loadJSONFile(legacyPath);
+        if (legacyConfig) {
+            if (!project)
+                projectName = legacyConfig.projectId || projectName;
+            if (!dbPath && legacyConfig.dbPath) {
+                // Keep existing DB path from legacy config
+                resolvedDbPath = legacyConfig.dbPath;
+            }
+            migrated = true;
+        }
+    }
+    // Build V1 config
+    const config = {
+        version: 1,
+        project: projectName,
+        database: {
+            path: resolvedDbPath,
+            wal: true,
+        },
+        defaults: {
+            autoSeed: true,
+            scope: global ? 'personal' : 'project',
+        },
+    };
+    // Write config
+    (0, fs_1.mkdirSync)(configDir, { recursive: true });
+    (0, fs_1.writeFileSync)(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return {
+        configPath,
+        dbPath: global
+            ? (0, path_1.join)(GLOBAL_CONFIG_DIR, resolvedDbPath)
+            : (0, path_1.join)(resolvedDir, resolvedDbPath),
+        projectDir: resolvedDir,
+        migrated,
+        backupPath,
+    };
+}
+// ─── Config Migration ──────────────────────────────────────
+/**
+ * Migrate a legacy .mementorc to the new .memento/config.json format.
+ * Backs up the original file as .mementorc.bak.
+ */
+function migrateConfig(sourceDir = process.cwd()) {
+    const sourcePath = (0, path_1.join)(sourceDir, LEGACY_CONFIG_FILE);
+    const targetDir = (0, path_1.join)(sourceDir, NEW_CONFIG_DIR);
+    const targetPath = (0, path_1.join)(targetDir, NEW_CONFIG_FILE);
+    const backupPath = sourcePath + '.bak';
+    // Validate source exists
+    if (!(0, fs_1.existsSync)(sourcePath)) {
+        return {
+            success: false,
+            sourcePath,
+            targetPath,
+            backupPath,
+            config: {},
+            error: `No .mementorc found at ${sourcePath}`,
+        };
+    }
+    // Load and validate legacy config
+    const legacyConfig = loadJSONFile(sourcePath);
+    if (!legacyConfig) {
+        return {
+            success: false,
+            sourcePath,
+            targetPath,
+            backupPath,
+            config: {},
+            error: `Failed to parse ${sourcePath}`,
+        };
+    }
+    // Convert to V1
+    const v1Config = legacyToConfigV1(legacyConfig, sourceDir);
+    // Create target directory
+    (0, fs_1.mkdirSync)(targetDir, { recursive: true });
+    // Write new config
+    (0, fs_1.writeFileSync)(targetPath, JSON.stringify(v1Config, null, 2) + '\n', 'utf-8');
+    // Backup original
+    (0, fs_1.renameSync)(sourcePath, backupPath);
+    return {
+        success: true,
+        sourcePath,
+        targetPath,
+        backupPath,
+        config: v1Config,
+    };
 }
 //# sourceMappingURL=ConfigManager.js.map

package/dist/ConfigManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigManager.js","sourceRoot":"","sources":["../src/ConfigManager.ts"],"names":[],"mappings":";;AAiCA,8CA0BC;AAED,gCA8BC;AAED,gDAYC;AAED,sCAYC;AAED,oCASC;AAlID,2BAA8C;AAC9C,+BAAqC;AACrC,2BAA6B;AAS7B,MAAM,cAAc,GAAkB;IACpC,aAAa,EAAE,UAAU;IACzB,MAAM,EAAE,wBAAwB;IAChC,WAAW,EAAE,kBAAkB;CAChC,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACjE,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,SAAS,YAAY,CAAI,IAAY;IACnC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAChE,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAEvD,IAAI,IAAA,eAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,YAAY,CAAgB,UAAU,CAAC,CAAC;YACvD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,cAAO,EAAC,UAAU,CAAC,CAAC;QAEtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,UAAU,GAAG,SAAS,CAAC;QACvB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,UAAU;IACxB,IAAI,MAAM,GAAkB,EAAE,GAAG,cAAc,EAAE,CAAC;IAElD,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;IAC1C,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAgB,kBAAkB,CAAC,CAAC;IACrE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACvC,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAgD,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACrC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAqB;IACtD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAY,CAAC;IAEtE,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,aAAa,CAAC,MAAqB;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC,MAAO,CAAC;IAEvD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,YAAY,CAAC,MAAqB;IAChD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,YAAY,CAAoB,eAAe,CAAC,CAAC;IAErE,OAAO,WAAW,EAAE,IAAI,IAAI,SAAS,CAAC;AACxC,CAAC"}
+{"version":3,"file":"ConfigManager.js","sourceRoot":"","sources":["../src/ConfigManager.ts"],"names":[],"mappings":"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"}

package/dist/EmbeddingService.d.ts

@@ -0,0 +1,54 @@
+/**
+ * EmbeddingService.ts — Local embedding generation with graceful degradation.
+ *
+ * Uses @huggingface/transformers (optional peer dependency) to generate
+ * 384-dim embeddings via Xenova/all-MiniLM-L6-v2.
+ *
+ * If the library is not installed, all operations return null/empty
+ * and the system falls back to FTS5 keyword search.
+ *
+ * Privacy: Zero network requests after initial model download (cached).
+ */
+export interface EmbeddingResult {
+    embedding: Float32Array;
+    dimensions: number;
+    model: string;
+}
+export interface EmbeddingStatus {
+    available: boolean;
+    model: string | null;
+    error: string | null;
+}
+export declare class EmbeddingService {
+    private embedFn;
+    private initPromise;
+    private modelName;
+    private dimensions;
+    private _status;
+    get status(): EmbeddingStatus;
+    /**
+     * Initialize the embedding model lazily.
+     * Safe to call multiple times — only initializes once.
+     */
+    initialize(): Promise<void>;
+    private _initialize;
+    /**
+     * Generate embedding for a text string.
+     * Returns null if embedding service is unavailable.
+     */
+    generate(text: string): Promise<EmbeddingResult | null>;
+    /**
+     * Serialize Float32Array to Buffer for SQLite BLOB storage.
+     */
+    static serializeEmbedding(embedding: Float32Array): Buffer;
+    /**
+     * Deserialize SQLite BLOB to Float32Array.
+     */
+    static deserializeEmbedding(blob: Buffer | Uint8Array, dimensions: number): Float32Array;
+    /**
+     * Calculate cosine similarity between two embeddings.
+     * Returns value in [-1, 1] range.
+     */
+    static cosineSimilarity(a: Float32Array, b: Float32Array): number;
+}
+//# sourceMappingURL=EmbeddingService.d.ts.map

package/dist/EmbeddingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingService.d.ts","sourceRoot":"","sources":["../src/EmbeddingService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,OAAO,CAIb;IAEF,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,WAAW;IA8CzB;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoB7D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM;IAI1D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;IAQxF;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;CAkBlE"}

package/dist/EmbeddingService.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * EmbeddingService.ts — Local embedding generation with graceful degradation.
+ *
+ * Uses @huggingface/transformers (optional peer dependency) to generate
+ * 384-dim embeddings via Xenova/all-MiniLM-L6-v2.
+ *
+ * If the library is not installed, all operations return null/empty
+ * and the system falls back to FTS5 keyword search.
+ *
+ * Privacy: Zero network requests after initial model download (cached).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingService = void 0;
+class EmbeddingService {
+    embedFn = null;
+    initPromise = null;
+    modelName = 'Xenova/all-MiniLM-L6-v2';
+    dimensions = 384;
+    _status = {
+        available: false,
+        model: null,
+        error: null,
+    };
+    get status() {
+        return this._status;
+    }
+    /**
+     * Initialize the embedding model lazily.
+     * Safe to call multiple times — only initializes once.
+     */
+    async initialize() {
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this._initialize();
+        return this.initPromise;
+    }
+    async _initialize() {
+        try {
+            // Dynamic import — if @huggingface/transformers is not installed,
+            // this will fail gracefully
+            const transformers = await import('@huggingface/transformers');
+            const pipeline = transformers.pipeline ||
+                transformers.default?.pipeline;
+            if (!pipeline) {
+                throw new Error('pipeline function not found in @huggingface/transformers');
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const extractor = await pipeline('feature-extraction', this.modelName, { quantized: true });
+            this.embedFn = async (text) => {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const output = await extractor(text, { pooling: 'mean', normalize: true });
+                // Extract the tensor data as Float32Array
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const data = output.data || output.tolist?.() || output;
+                if (data instanceof Float32Array)
+                    return data;
+                // Fallback: convert from regular array
+                return new Float32Array(Array.isArray(data) ? data : Array.from(data));
+            };
+            this._status = {
+                available: true,
+                model: this.modelName,
+                error: null,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this._status = {
+                available: false,
+                model: null,
+                error: message,
+            };
+            // Don't throw — graceful degradation
+        }
+    }
+    /**
+     * Generate embedding for a text string.
+     * Returns null if embedding service is unavailable.
+     */
+    async generate(text) {
+        if (!this.embedFn) {
+            await this.initialize();
+            if (!this.embedFn)
+                return null;
+        }
+        try {
+            // Truncate to 512 tokens worth of text (~2000 chars)
+            const truncated = text.length > 2000 ? text.slice(0, 2000) : text;
+            const embedding = await this.embedFn(truncated);
+            return {
+                embedding,
+                dimensions: this.dimensions,
+                model: this.modelName,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Serialize Float32Array to Buffer for SQLite BLOB storage.
+     */
+    static serializeEmbedding(embedding) {
+        return Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+    }
+    /**
+     * Deserialize SQLite BLOB to Float32Array.
+     */
+    static deserializeEmbedding(blob, dimensions) {
+        return new Float32Array((blob instanceof Buffer ? blob : Buffer.from(blob)).buffer, (blob instanceof Buffer ? blob : Buffer.from(blob)).byteOffset, dimensions);
+    }
+    /**
+     * Calculate cosine similarity between two embeddings.
+     * Returns value in [-1, 1] range.
+     */
+    static cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        if (denominator === 0)
+            return 0;
+        return dotProduct / denominator;
+    }
+}
+exports.EmbeddingService = EmbeddingService;
+//# sourceMappingURL=EmbeddingService.js.map

package/dist/EmbeddingService.js.map

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