@jungjaehoon/mama-core 1.1.2 → 1.1.3

package/dist/config-loader.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MAMA Configuration Loader
+ *
+ * Story M1.4: Configurable embedding model selection
+ * Priority: P1 (Core Feature)
+ *
+ * Loads user configuration from ~/.mama/config.json with sensible defaults.
+ * Supports:
+ * - Model selection (default: multilingual-e5-small)
+ * - Embedding dimensions
+ * - Cache directory configuration
+ *
+ * @module config-loader
+ */
+export interface MAMAConfig {
+    modelName: string;
+    embeddingDim: number;
+    cacheDir: string;
+    [key: string]: unknown;
+}
+export declare const DEFAULT_CONFIG: MAMAConfig;
+/**
+ * Load MAMA configuration from ~/.mama/config.json
+ *
+ * Story M1.4 AC #1: Config parser loads ~/.mama/config.json
+ *
+ * @param reload - Force reload from disk (default: false)
+ * @returns Configuration object with modelName, embeddingDim, cacheDir
+ */
+export declare function loadConfig(reload?: boolean): MAMAConfig;
+/**
+ * Get current model name
+ */
+export declare function getModelName(): string;
+/**
+ * Get current embedding dimension
+ */
+export declare function getEmbeddingDim(): number;
+/**
+ * Get current cache directory
+ */
+export declare function getCacheDir(): string;
+export interface ConfigUpdates {
+    modelName?: string;
+    embeddingDim?: number;
+    cacheDir?: string;
+}
+/**
+ * Update configuration and save to file
+ *
+ * Story M1.4 AC #3: Changing model via config triggers informative log + resets caches
+ *
+ * @param updates - Configuration updates
+ * @returns Success status
+ */
+export declare function updateConfig(updates: ConfigUpdates): boolean;
+/**
+ * Get config file path
+ */
+export declare function getConfigPath(): string;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * MAMA Configuration Loader
+ *
+ * Story M1.4: Configurable embedding model selection
+ * Priority: P1 (Core Feature)
+ *
+ * Loads user configuration from ~/.mama/config.json with sensible defaults.
+ * Supports:
+ * - Model selection (default: multilingual-e5-small)
+ * - Embedding dimensions
+ * - Cache directory configuration
+ *
+ * @module config-loader
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.loadConfig = loadConfig;
+exports.getModelName = getModelName;
+exports.getEmbeddingDim = getEmbeddingDim;
+exports.getCacheDir = getCacheDir;
+exports.updateConfig = updateConfig;
+exports.getConfigPath = getConfigPath;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const debug_logger_js_1 = require("./debug-logger.js");
+// Default configuration
+exports.DEFAULT_CONFIG = {
+    modelName: 'Xenova/multilingual-e5-small',
+    embeddingDim: 384,
+    cacheDir: path_1.default.join(os_1.default.homedir(), '.cache', 'huggingface', 'transformers'),
+};
+// Config file path
+const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.mama');
+const CONFIG_PATH = path_1.default.join(CONFIG_DIR, 'config.json');
+// Cached configuration
+let cachedConfig = null;
+/**
+ * Ensure config directory exists
+ */
+function ensureConfigDir() {
+    if (!fs_1.default.existsSync(CONFIG_DIR)) {
+        fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
+        (0, debug_logger_js_1.info)(`[config] Created config directory: ${CONFIG_DIR}`);
+    }
+}
+/**
+ * Create default config file if it doesn't exist
+ */
+function ensureConfigFile() {
+    if (!fs_1.default.existsSync(CONFIG_PATH)) {
+        ensureConfigDir();
+        fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(exports.DEFAULT_CONFIG, null, 2), 'utf8');
+        (0, debug_logger_js_1.info)(`[config] Created default config file: ${CONFIG_PATH}`);
+        (0, debug_logger_js_1.info)(`[config] Model: ${exports.DEFAULT_CONFIG.modelName} (${exports.DEFAULT_CONFIG.embeddingDim}-dim)`);
+    }
+}
+/**
+ * Load MAMA configuration from ~/.mama/config.json
+ *
+ * Story M1.4 AC #1: Config parser loads ~/.mama/config.json
+ *
+ * @param reload - Force reload from disk (default: false)
+ * @returns Configuration object with modelName, embeddingDim, cacheDir
+ */
+function loadConfig(reload = false) {
+    // Return cached config if available and not forcing reload
+    if (cachedConfig && !reload) {
+        return cachedConfig;
+    }
+    try {
+        // Ensure config file exists
+        ensureConfigFile();
+        // Read and parse config file
+        const configData = fs_1.default.readFileSync(CONFIG_PATH, 'utf8');
+        const userConfig = JSON.parse(configData);
+        // Merge with defaults (user config overrides)
+        const config = {
+            ...exports.DEFAULT_CONFIG,
+            ...userConfig,
+        };
+        // Validate configuration
+        if (!config.modelName || typeof config.modelName !== 'string') {
+            (0, debug_logger_js_1.warn)('[config] Invalid modelName, using default:', exports.DEFAULT_CONFIG.modelName);
+            config.modelName = exports.DEFAULT_CONFIG.modelName;
+        }
+        if (!Number.isInteger(config.embeddingDim) || config.embeddingDim <= 0) {
+            (0, debug_logger_js_1.warn)('[config] Invalid embeddingDim, using default:', exports.DEFAULT_CONFIG.embeddingDim);
+            config.embeddingDim = exports.DEFAULT_CONFIG.embeddingDim;
+        }
+        if (!config.cacheDir || typeof config.cacheDir !== 'string') {
+            (0, debug_logger_js_1.warn)('[config] Invalid cacheDir, using default:', exports.DEFAULT_CONFIG.cacheDir);
+            config.cacheDir = exports.DEFAULT_CONFIG.cacheDir;
+        }
+        // Cache the loaded config
+        cachedConfig = config;
+        // Log loaded configuration
+        if (reload) {
+            (0, debug_logger_js_1.info)(`[config] Configuration reloaded from ${CONFIG_PATH}`);
+            (0, debug_logger_js_1.info)(`[config] Model: ${config.modelName} (${config.embeddingDim}-dim)`);
+            (0, debug_logger_js_1.info)(`[config] Cache: ${config.cacheDir}`);
+        }
+        return config;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        (0, debug_logger_js_1.error)(`[config] Failed to load config file: ${message}`);
+        (0, debug_logger_js_1.error)('[config] Using default configuration');
+        // Cache defaults on error
+        cachedConfig = { ...exports.DEFAULT_CONFIG };
+        return cachedConfig;
+    }
+}
+/**
+ * Get current model name
+ */
+function getModelName() {
+    const config = loadConfig();
+    return config.modelName;
+}
+/**
+ * Get current embedding dimension
+ */
+function getEmbeddingDim() {
+    const config = loadConfig();
+    return config.embeddingDim;
+}
+/**
+ * Get current cache directory
+ */
+function getCacheDir() {
+    const config = loadConfig();
+    return config.cacheDir;
+}
+/**
+ * Update configuration and save to file
+ *
+ * Story M1.4 AC #3: Changing model via config triggers informative log + resets caches
+ *
+ * @param updates - Configuration updates
+ * @returns Success status
+ */
+function updateConfig(updates) {
+    try {
+        ensureConfigFile();
+        // Load current config
+        const currentConfig = loadConfig();
+        // Check if model is changing
+        const modelChanged = updates.modelName && updates.modelName !== currentConfig.modelName;
+        const dimChanged = updates.embeddingDim && updates.embeddingDim !== currentConfig.embeddingDim;
+        // Merge updates
+        const newConfig = {
+            ...currentConfig,
+            ...updates,
+        };
+        // Save to file
+        fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(newConfig, null, 2), 'utf8');
+        // Update cache
+        cachedConfig = newConfig;
+        // Story M1.4 AC #3: Informative log when model changes
+        if (modelChanged || dimChanged) {
+            (0, debug_logger_js_1.info)('[config] ⚠️  Embedding model configuration changed');
+            (0, debug_logger_js_1.info)(`[config] Old: ${currentConfig.modelName} (${currentConfig.embeddingDim}-dim)`);
+            (0, debug_logger_js_1.info)(`[config] New: ${newConfig.modelName} (${newConfig.embeddingDim}-dim)`);
+            (0, debug_logger_js_1.info)('[config] ⚡ Model cache will be reset on next embedding generation');
+            (0, debug_logger_js_1.info)('[config] ⚡ Existing embeddings in database remain unchanged');
+        }
+        (0, debug_logger_js_1.info)(`[config] Configuration saved to ${CONFIG_PATH}`);
+        return true;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        (0, debug_logger_js_1.error)(`[config] Failed to update config: ${message}`);
+        return false;
+    }
+}
+/**
+ * Get config file path
+ */
+function getConfigPath() {
+    return CONFIG_PATH;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/db-adapter/base-adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Base Database Adapter Interface
+ * All adapters must implement these methods
+ */
+import type { Statement, RunResult } from './statement.js';
+export type { Statement, RunResult };
+export interface VectorSearchResult {
+    rowid: number;
+    similarity?: number;
+    distance?: number;
+}
+export declare abstract class DatabaseAdapter {
+    /**
+     * Connect to database
+     * @returns Database connection
+     */
+    abstract connect(): unknown;
+    /**
+     * Disconnect from database
+     */
+    abstract disconnect(): void;
+    /**
+     * Check if connected
+     * @returns Connection status
+     */
+    abstract isConnected(): boolean;
+    /**
+     * Prepare a SQL statement
+     * @param sql - SQL query
+     * @returns Prepared statement
+     */
+    abstract prepare(sql: string): Statement;
+    /**
+     * Execute raw SQL
+     * @param sql - SQL to execute
+     */
+    abstract exec(sql: string): void;
+    /**
+     * Execute function in transaction
+     * @param fn - Function to execute
+     * @returns Function return value
+     */
+    abstract transaction<T>(fn: () => T): T;
+    /**
+     * Vector similarity search
+     * @param embedding - Query embedding (384-dim)
+     * @param limit - Max results
+     * @returns Search results with distance
+     */
+    abstract vectorSearch(embedding: Float32Array | number[], limit: number): VectorSearchResult[] | null;
+    /**
+     * Insert vector embedding
+     * @param rowid - Decision rowid
+     * @param embedding - Embedding vector
+     */
+    abstract insertEmbedding(rowid: number, embedding: Float32Array | number[]): RunResult | null;
+    /**
+     * Get last inserted row ID
+     * @returns Last rowid
+     */
+    abstract getLastInsertRowid(): number;
+    /**
+     * Run migrations
+     * @param migrationsDir - Path to migrations directory
+     */
+    abstract runMigrations(migrationsDir: string): void;
+    /**
+     * Check if vector search is enabled
+     */
+    abstract get vectorSearchEnabled(): boolean;
+    /**
+     * Get database path
+     */
+    abstract getDbPath(): string;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/db-adapter/base-adapter.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Base Database Adapter Interface
+ * All adapters must implement these methods
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseAdapter = void 0;
+class DatabaseAdapter {
+}
+exports.DatabaseAdapter = DatabaseAdapter;
+//# sourceMappingURL=base-adapter.js.map

package/dist/db-adapter/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Database Adapter Factory (SQLite-only)
+ *
+ * MAMA Plugin uses SQLite exclusively for local storage.
+ * PostgreSQL support is only available in the legacy mcp-server.
+ *
+ * @module db-adapter
+ */
+import { SQLiteAdapter } from './sqlite-adapter.js';
+import { DatabaseAdapter, type VectorSearchResult, type RunResult } from './base-adapter.js';
+import type { Statement } from './statement.js';
+export { DatabaseAdapter, SQLiteAdapter };
+export type { Statement, VectorSearchResult, RunResult };
+export interface AdapterConfig {
+    dbPath?: string;
+}
+/**
+ * Create SQLite database adapter
+ *
+ * @param config - Database configuration
+ * @returns Configured SQLite adapter instance
+ */
+export declare function createAdapter(config?: AdapterConfig): DatabaseAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/db-adapter/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Database Adapter Factory (SQLite-only)
+ *
+ * MAMA Plugin uses SQLite exclusively for local storage.
+ * PostgreSQL support is only available in the legacy mcp-server.
+ *
+ * @module db-adapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteAdapter = exports.DatabaseAdapter = void 0;
+exports.createAdapter = createAdapter;
+const debug_logger_js_1 = require("../debug-logger.js");
+const sqlite_adapter_js_1 = require("./sqlite-adapter.js");
+Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return sqlite_adapter_js_1.SQLiteAdapter; } });
+const base_adapter_js_1 = require("./base-adapter.js");
+Object.defineProperty(exports, "DatabaseAdapter", { enumerable: true, get: function () { return base_adapter_js_1.DatabaseAdapter; } });
+/**
+ * Create SQLite database adapter
+ *
+ * @param config - Database configuration
+ * @returns Configured SQLite adapter instance
+ */
+function createAdapter(config = {}) {
+    (0, debug_logger_js_1.info)('[db-adapter] Using SQLite adapter (plugin mode)');
+    const dbPath = config.dbPath || process.env.MAMA_DB_PATH;
+    return new sqlite_adapter_js_1.SQLiteAdapter({ dbPath });
+}
+//# sourceMappingURL=index.js.map

package/dist/db-adapter/sqlite-adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SQLite Database Adapter
+ *
+ * Implements DatabaseAdapter interface using better-sqlite3 + sqlite-vec
+ * This is the current production implementation extracted from memory-store.js
+ *
+ * @module sqlite-adapter
+ */
+import Database from 'better-sqlite3';
+import { DatabaseAdapter, type VectorSearchResult, type RunResult } from './base-adapter.js';
+import { type Statement } from './statement.js';
+/**
+ * Adapter configuration
+ */
+interface SQLiteAdapterConfig {
+    dbPath?: string;
+}
+export declare class SQLiteAdapter extends DatabaseAdapter {
+    private config;
+    private db;
+    private _vectorSearchEnabled;
+    constructor(config?: SQLiteAdapterConfig);
+    /**
+     * Check if vector search is enabled
+     */
+    get vectorSearchEnabled(): boolean;
+    /**
+     * Get database path with backward compatibility
+     */
+    getDbPath(): string;
+    /**
+     * Connect to SQLite database
+     */
+    connect(): Database.Database;
+    /**
+     * Disconnect from database
+     */
+    disconnect(): void;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Prepare a SQL statement
+     */
+    prepare(sql: string): Statement;
+    /**
+     * Execute raw SQL
+     */
+    exec(sql: string): void;
+    /**
+     * Execute function in transaction
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Vector similarity search using sqlite-vec (vec0 virtual table)
+     */
+    vectorSearch(embedding: Float32Array | number[], limit?: number): VectorSearchResult[] | null;
+    /**
+     * Insert vector embedding
+     */
+    insertEmbedding(rowid: number, embedding: Float32Array | number[]): RunResult | null;
+    /**
+     * Get last inserted row ID
+     */
+    getLastInsertRowid(): number;
+    /**
+     * Run migrations
+     */
+    runMigrations(migrationsDir: string): void;
+}
+export default SQLiteAdapter;
+//# sourceMappingURL=sqlite-adapter.d.ts.map