@jungjaehoon/mama-core 1.4.0 → 1.4.2

package/db/migrations/001-initial-decision-graph.sql

@@ -124,7 +124,7 @@ CREATE INDEX IF NOT EXISTS idx_sessions_last_active ON sessions(last_active_at);
 -- because sqlite-vss requires extension loading first
 --
 -- CREATE VIRTUAL TABLE vss_memories USING vss0(
---   embedding(384)                    -- multilingual-e5-small embeddings
+--   embedding(1024)                   -- multilingual-e5-large embeddings
 -- );
 
 -- ══════════════════════════════════════════════════════════════

package/db/migrations/002-add-error-patterns.sql

@@ -33,7 +33,7 @@ CREATE TABLE IF NOT EXISTS error_patterns (
   first_seen INTEGER NOT NULL,     -- First occurrence timestamp
 
   -- Vector Embedding (for semantic matching)
-  embedding BLOB,                  -- 384-dim embedding (multilingual-e5-small)
+  embedding BLOB,                  -- 1024-dim embedding (multilingual-e5-large)
 
   -- Metadata
   created_at INTEGER DEFAULT (unixepoch() * 1000),

package/db/migrations/025-extend-kind-check.sql

@@ -0,0 +1,59 @@
+-- v0.17: Extend kind CHECK constraint to include 'task' and 'schedule'.
+-- Only runs if the old CHECK exists (idempotent).
+-- Uses a temp table approach since SQLite cannot ALTER CHECK constraints.
+
+-- Drop the old column constraint by recreating the table
+-- This is safe because we explicitly list all columns
+
+CREATE TABLE IF NOT EXISTS decisions_v17 (
+  id TEXT PRIMARY KEY,
+  topic TEXT NOT NULL,
+  decision TEXT NOT NULL,
+  reasoning TEXT,
+  outcome TEXT,
+  failure_reason TEXT,
+  limitation TEXT,
+  user_involvement TEXT,
+  session_id TEXT,
+  supersedes TEXT,
+  superseded_by TEXT,
+  refined_from TEXT,
+  confidence REAL DEFAULT 0.5 CHECK (confidence >= 0.0 AND confidence <= 1.0),
+  created_at INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
+  updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
+  needs_validation INTEGER DEFAULT 0 CHECK (needs_validation IN (0, 1)),
+  validation_attempts INTEGER DEFAULT 0,
+  last_validated_at INTEGER,
+  usage_count INTEGER DEFAULT 0,
+  trust_context TEXT,
+  usage_success INTEGER DEFAULT 0,
+  usage_failure INTEGER DEFAULT 0,
+  time_saved INTEGER DEFAULT 0,
+  evidence TEXT,
+  alternatives TEXT,
+  risks TEXT,
+  event_date TEXT,
+  kind TEXT DEFAULT 'decision'
+    CHECK (kind IN ('decision', 'preference', 'constraint', 'lesson', 'fact', 'task', 'schedule')),
+  status TEXT DEFAULT 'active'
+    CHECK (status IN ('active', 'superseded', 'contradicted', 'stale')),
+  summary TEXT,
+  is_static INTEGER DEFAULT 0
+);
+
+INSERT OR IGNORE INTO decisions_v17 (
+  id, topic, decision, reasoning, outcome, failure_reason, limitation,
+  user_involvement, session_id, supersedes, superseded_by, refined_from,
+  confidence, created_at, updated_at, needs_validation, validation_attempts,
+  last_validated_at, usage_count, trust_context, usage_success, usage_failure,
+  time_saved, evidence, alternatives, risks, event_date, kind, status, summary, is_static
+) SELECT
+  id, topic, decision, reasoning, outcome, failure_reason, limitation,
+  user_involvement, session_id, supersedes, superseded_by, refined_from,
+  confidence, created_at, updated_at, needs_validation, validation_attempts,
+  last_validated_at, usage_count, trust_context, usage_success, usage_failure,
+  time_saved, evidence, alternatives, risks, event_date, kind, status, summary, is_static
+FROM decisions;
+
+DROP TABLE decisions;
+ALTER TABLE decisions_v17 RENAME TO decisions;

package/dist/config-loader.d.ts

@@ -6,13 +6,14 @@
  *
  * Loads user configuration from ~/.mama/config.json with sensible defaults.
  * Supports:
- * - Model selection (default: multilingual-e5-small)
+ * - Model selection (default: multilingual-e5-large)
  * - Embedding dimensions
  * - Cache directory configuration
  *
  * @module config-loader
  */
 export interface MAMAConfig {
+    configVersion: number;
     modelName: string;
     embeddingDim: number;
     quantized: boolean;

package/dist/config-loader.js

@@ -7,7 +7,7 @@
  *
  * Loads user configuration from ~/.mama/config.json with sensible defaults.
  * Supports:
- * - Model selection (default: multilingual-e5-small)
+ * - Model selection (default: multilingual-e5-large)
  * - Embedding dimensions
  * - Cache directory configuration
  *
@@ -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 = {
-    modelName: 'Xenova/multilingual-e5-small',
-    embeddingDim: 384,
+    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/dist/db-adapter/base-adapter.d.ts

@@ -43,7 +43,7 @@ export declare abstract class DatabaseAdapter {
     abstract transaction<T>(fn: () => T): T;
     /**
      * Vector similarity search
-     * @param embedding - Query embedding (384-dim)
+     * @param embedding - Query embedding (1024-dim)
      * @param limit - Max results
      * @returns Search results with distance
      */

package/dist/db-manager.d.ts

@@ -156,7 +156,7 @@ export declare function listScopesForMemory(memoryId: string): Promise<Array<{
  * Stores embedding in the embeddings table for vector similarity search
  *
  * @param decisionRowid - SQLite rowid
- * @param embedding - 384-dim embedding vector
+ * @param embedding - 1024-dim embedding vector
  */
 export declare function insertEmbedding(decisionRowid: number, embedding: Float32Array | number[]): Promise<void>;
 /**
@@ -164,7 +164,7 @@ export declare function insertEmbedding(decisionRowid: number, embedding: Float3
  *
  * Returns empty array if vector search not available (no keyword fallback)
  *
- * @param queryEmbedding - Query embedding (384-dim)
+ * @param queryEmbedding - Query embedding (1024-dim)
  * @param limit - Max results to return (default: 5)
  * @param threshold - Minimum similarity threshold (default: 0.7)
  * @returns Array of decisions with similarity scores, or empty array

package/dist/db-manager.js

@@ -189,7 +189,7 @@ async function listScopesForMemory(memoryId) {
  * Stores embedding in the embeddings table for vector similarity search
  *
  * @param decisionRowid - SQLite rowid
- * @param embedding - 384-dim embedding vector
+ * @param embedding - 1024-dim embedding vector
  */
 async function insertEmbedding(decisionRowid, embedding) {
     const adapter = getAdapter();
@@ -207,7 +207,7 @@ async function insertEmbedding(decisionRowid, embedding) {
  *
  * Returns empty array if vector search not available (no keyword fallback)
  *
- * @param queryEmbedding - Query embedding (384-dim)
+ * @param queryEmbedding - Query embedding (1024-dim)
  * @param limit - Max results to return (default: 5)
  * @param threshold - Minimum similarity threshold (default: 0.7)
  * @returns Array of decisions with similarity scores, or empty array

package/dist/embeddings.d.ts

@@ -2,7 +2,7 @@
  * MAMA (Memory-Augmented MCP Architecture) - Embedding Generation
  *
  * Story M1.4: Configurable embedding model selection
- * Generates embeddings using configurable model (default: multilingual-e5-small)
+ * Generates embeddings using configurable model (default: multilingual-e5-large)
  * Supports: Korean-English cross-lingual similarity, enhanced metadata
  *
  * @module embeddings
@@ -43,7 +43,7 @@ export declare function generateEmbedding(text: string): Promise<Float32Array>;
  * Inspired by A-mem: Content + Metadata for richer semantic representation
  *
  * @param decision - Decision object
- * @returns 384-dim enhanced embedding
+ * @returns 1024-dim enhanced embedding
  */
 export declare function generateEnhancedEmbedding(decision: DecisionForEmbedding): Promise<Float32Array>;
 /**

package/dist/embeddings.js

@@ -3,7 +3,7 @@
  * MAMA (Memory-Augmented MCP Architecture) - Embedding Generation
  *
  * Story M1.4: Configurable embedding model selection
- * Generates embeddings using configurable model (default: multilingual-e5-small)
+ * Generates embeddings using configurable model (default: multilingual-e5-large)
  * Supports: Korean-English cross-lingual similarity, enhanced metadata
  *
  * @module embeddings
@@ -142,7 +142,7 @@ async function generateEmbedding(text) {
  * Inspired by A-mem: Content + Metadata for richer semantic representation
  *
  * @param decision - Decision object
- * @returns 384-dim enhanced embedding
+ * @returns 1024-dim enhanced embedding
  */
 async function generateEnhancedEmbedding(decision) {
     // Construct enriched text representation with narrative fields (Story 2.2)

package/dist/memory/types.d.ts

@@ -1,6 +1,6 @@
 export declare const MEMORY_SCOPE_KINDS: readonly ["global", "user", "channel", "project"];
 export type MemoryScopeKind = (typeof MEMORY_SCOPE_KINDS)[number];
-export declare const MEMORY_KINDS: readonly ["decision", "preference", "constraint", "lesson", "fact"];
+export declare const MEMORY_KINDS: readonly ["decision", "preference", "constraint", "lesson", "fact", "task", "schedule", "compiled"];
 export type MemoryKind = (typeof MEMORY_KINDS)[number];
 export declare const MEMORY_STATUSES: readonly ["active", "superseded", "contradicted", "stale"];
 export type MemoryStatus = (typeof MEMORY_STATUSES)[number];

package/dist/memory/types.js

@@ -5,7 +5,16 @@ exports.createEmptyRecallBundle = createEmptyRecallBundle;
 exports.createEmptyMemoryAgentBootstrap = createEmptyMemoryAgentBootstrap;
 exports.createMemoryAuditAck = createMemoryAuditAck;
 exports.MEMORY_SCOPE_KINDS = ['global', 'user', 'channel', 'project'];
-exports.MEMORY_KINDS = ['decision', 'preference', 'constraint', 'lesson', 'fact'];
+exports.MEMORY_KINDS = [
+    'decision',
+    'preference',
+    'constraint',
+    'lesson',
+    'fact',
+    'task',
+    'schedule',
+    'compiled',
+];
 exports.MEMORY_STATUSES = ['active', 'superseded', 'contradicted', 'stale'];
 exports.MEMORY_TRUTH_STATUSES = [
     'active',

package/package.json

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