@jungjaehoon/mama-core 1.4.1 → 1.4.2

package/dist/config-loader.d.ts

@@ -13,6 +13,7 @@
  * @module config-loader
  */
 export interface MAMAConfig {
+    configVersion: number;
     modelName: string;
     embeddingDim: number;
     quantized: boolean;

package/dist/config-loader.js

@@ -29,13 +29,48 @@ 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");
+// Current config version — bump this when adding migrations
+const CURRENT_CONFIG_VERSION = 2;
 // Default configuration
 exports.DEFAULT_CONFIG = {
+    configVersion: CURRENT_CONFIG_VERSION,
     modelName: 'Xenova/multilingual-e5-large',
     embeddingDim: 1024,
     quantized: true,
     cacheDir: path_1.default.join(os_1.default.homedir(), '.cache', 'huggingface', 'transformers'),
 };
+/**
+ * Config migrations — each entry upgrades from (version - 1) to version.
+ * Migrations run sequentially and mutate the config object in place.
+ */
+const CONFIG_MIGRATIONS = {
+    // v1 → v2: e5-small (384-dim) → e5-large (1024-dim)
+    2: (cfg) => {
+        if (cfg.modelName === 'Xenova/multilingual-e5-small' && cfg.embeddingDim === 384) {
+            (0, debug_logger_js_1.info)('[config] Migration v2: upgrading embedding model e5-small → e5-large');
+            cfg.modelName = 'Xenova/multilingual-e5-large';
+            cfg.embeddingDim = 1024;
+        }
+    },
+};
+/**
+ * Apply pending migrations to a config object.
+ * Returns true if any migrations were applied.
+ */
+function applyMigrations(config) {
+    const startVersion = config.configVersion || 1;
+    if (startVersion >= CURRENT_CONFIG_VERSION)
+        return false;
+    for (let v = startVersion + 1; v <= CURRENT_CONFIG_VERSION; v++) {
+        const migrate = CONFIG_MIGRATIONS[v];
+        if (migrate) {
+            migrate(config);
+            (0, debug_logger_js_1.info)(`[config] Applied migration v${v}`);
+        }
+    }
+    config.configVersion = CURRENT_CONFIG_VERSION;
+    return true;
+}
 // 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');
@@ -80,11 +115,19 @@ function loadConfig(reload = false) {
         // Read and parse config file
         const configData = fs_1.default.readFileSync(CONFIG_PATH, 'utf8');
         const userConfig = JSON.parse(configData);
+        // Determine file's config version before merging with defaults
+        const fileVersion = userConfig.configVersion || 1;
         // Merge with defaults (user config overrides)
         const config = {
             ...exports.DEFAULT_CONFIG,
             ...userConfig,
+            configVersion: fileVersion, // preserve file version for migration check
         };
+        // Apply pending migrations based on file's version
+        if (applyMigrations(config)) {
+            fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf8');
+            (0, debug_logger_js_1.info)(`[config] Migrated config saved to ${CONFIG_PATH}`);
+        }
         // Validate configuration
         if (!config.modelName || typeof config.modelName !== 'string') {
             (0, debug_logger_js_1.warn)('[config] Invalid modelName, using default:', exports.DEFAULT_CONFIG.modelName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",