memento-mcp-server 1.7.5 → 1.9.0

package/dist/utils/type-param-validator.js

@@ -0,0 +1,76 @@
+/**
+ * type 파라미터 롤아웃 모드 검증 유틸리티
+ *
+ * Phase 1 (warn): type 파라미터 없을 시 경고 로그 출력 및 기본값 적용
+ * Phase 2 (deprecate): type 파라미터 없을 시 Deprecation 경고 및 기본값 적용
+ * Phase 3 (error): type 파라미터 없을 시 에러 발생
+ */
+/**
+ * type 파라미터 검증 및 롤아웃 모드에 따른 처리
+ *
+ * @param type - 사용자가 제공한 type 파라미터 (없을 수 있음)
+ * @param mode - 롤아웃 모드 ('warn' | 'deprecate' | 'error')
+ * @param toolName - 도구 이름 (에러 메시지에 사용)
+ * @returns 검증 결과 및 기본값
+ */
+export function validateTypeParam(type, mode, toolName = 'tool') {
+    // type 파라미터가 제공된 경우
+    if (type !== undefined && type !== null && type !== '') {
+        return {
+            isValid: true,
+            mode,
+            defaultType: type
+        };
+    }
+    // type 파라미터가 없는 경우 - 모드에 따라 처리
+    const defaultType = 'episodic'; // 기본값
+    switch (mode) {
+        case 'warn':
+            return {
+                isValid: true,
+                mode: 'warn',
+                message: `⚠️  ${toolName}: 'type' 파라미터가 지정되지 않았습니다. 기본값 'episodic'을 사용합니다. 향후 버전에서는 필수 파라미터가 됩니다.`,
+                defaultType
+            };
+        case 'deprecate':
+            return {
+                isValid: true,
+                mode: 'deprecate',
+                message: `⚠️  [DEPRECATED] ${toolName}: 'type' 파라미터가 지정되지 않았습니다. 기본값 'episodic'을 사용합니다. 'type' 파라미터는 필수로 지정해주세요. 마이그레이션 가이드: https://github.com/your-repo/memento/blob/main/docs/migration-guide.md`,
+                defaultType
+            };
+        case 'error':
+            return {
+                isValid: false,
+                mode: 'error',
+                message: `❌ ${toolName}: 'type' 파라미터는 필수입니다. 'core' | 'episodic' | 'semantic' | 'procedural' | 'vault' | 'working' 중 하나를 지정해주세요.`
+            };
+        default:
+            // 알 수 없는 모드인 경우 warn 모드로 처리
+            return {
+                isValid: true,
+                mode: 'warn',
+                message: `⚠️  ${toolName}: 'type' 파라미터가 지정되지 않았습니다. 기본값 'episodic'을 사용합니다.`,
+                defaultType
+            };
+    }
+}
+/**
+ * 환경 변수에서 롤아웃 모드 읽기
+ *
+ * @param envValue - 환경 변수 값
+ * @returns 유효한 모드 또는 기본값 'warn'
+ */
+export function parseTypeParamMode(envValue) {
+    if (!envValue) {
+        return 'warn';
+    }
+    const normalized = envValue.toLowerCase().trim();
+    if (normalized === 'warn' || normalized === 'deprecate' || normalized === 'error') {
+        return normalized;
+    }
+    // 유효하지 않은 값인 경우 기본값 반환
+    console.warn(`⚠️  Invalid MEMENTO_TYPE_PARAM_MODE value: ${envValue}. Using default 'warn'.`);
+    return 'warn';
+}
+//# sourceMappingURL=type-param-validator.js.map

package/dist/utils/type-param-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-param-validator.js","sourceRoot":"","sources":["../../src/utils/type-param-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAwB,EACxB,IAAmB,EACnB,WAAmB,MAAM;IAEzB,oBAAoB;IACpB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,MAAM;IAEtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,QAAQ,0EAA0E;gBAClG,WAAW;aACZ,CAAC;QAEJ,KAAK,WAAW;YACd,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,oBAAoB,QAAQ,+JAA+J;gBACpM,WAAW;aACZ,CAAC;QAEJ,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,KAAK,QAAQ,2GAA2G;aAClI,CAAC;QAEJ;YACE,4BAA4B;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,QAAQ,mDAAmD;gBAC3E,WAAW;aACZ,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA4B;IAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAClF,OAAO,UAA2B,CAAC;IACrC,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,IAAI,CAAC,8CAA8C,QAAQ,yBAAyB,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp-server",
-  "version": "1.7.5",
+  "version": "1.9.0",
   "description": "AI Agent 기억 보조 MCP 서버 - 사람의 기억 구조를 모사한 스토리지+검색+요약+망각 메커니즘",
   "main": "dist/server/index.js",
   "type": "module",

package/src/database/schema.sql

@@ -15,7 +15,12 @@ CREATE TABLE IF NOT EXISTS memory_item (
   source TEXT,
   view_count INTEGER DEFAULT 0,
   cite_count INTEGER DEFAULT 0,
-  edit_count INTEGER DEFAULT 0
+  edit_count INTEGER DEFAULT 0,
+  -- MIRIX Schema Expansion (v2.0) 추가 필드
+  origin_source TEXT DEFAULT '{}', -- JSON 형식: {"tool": "remember", "caller": "user", "timestamp": "...", "context": {...}}
+  task_goal TEXT, -- Procedural Memory 전용, 작업 목표
+  steps TEXT, -- Procedural Memory 전용, JSON 배열 형식
+  reflection_notes TEXT -- Procedural Memory 전용, JSON 형식
 );
 
 -- 태그 테이블
@@ -229,6 +234,69 @@ CREATE TRIGGER IF NOT EXISTS memory_embedding_vec_delete AFTER DELETE ON memory_
   DELETE FROM memory_item_vec_gemini WHERE rowid = OLD.id;
 END;
 
+-- Core Memory 테이블 (MIRIX Schema Expansion v2.0)
+-- Core Memory는 에이전트의 핵심 정체성, 지침, 인격 데이터를 저장합니다.
+CREATE TABLE IF NOT EXISTS core_memory (
+  core_id TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL DEFAULT 'default',
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  always_load BOOLEAN NOT NULL DEFAULT 0,
+  origin_source TEXT DEFAULT '{}', -- JSON 형식
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(agent_id, key)
+);
+
+-- Core Memory 인덱스
+CREATE INDEX IF NOT EXISTS idx_core_memory_agent_id ON core_memory(agent_id);
+CREATE INDEX IF NOT EXISTS idx_core_memory_key ON core_memory(key);
+CREATE INDEX IF NOT EXISTS idx_core_memory_created_at ON core_memory(created_at);
+CREATE INDEX IF NOT EXISTS idx_core_memory_always_load ON core_memory(always_load);
+
+-- Core Memory updated_at 자동 업데이트 트리거
+CREATE TRIGGER IF NOT EXISTS core_memory_update_timestamp 
+AFTER UPDATE ON core_memory
+BEGIN
+  UPDATE core_memory 
+  SET updated_at = CURRENT_TIMESTAMP 
+  WHERE core_id = NEW.core_id;
+END;
+
+-- Knowledge Vault 테이블 (MIRIX Schema Expansion v2.0)
+-- Knowledge Vault는 변경 불가능한 영구 지식 저장소입니다.
+CREATE TABLE IF NOT EXISTS knowledge_vault (
+  vault_id TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL DEFAULT 'default',
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  immutable BOOLEAN NOT NULL DEFAULT 1,
+  version INTEGER NOT NULL DEFAULT 1,
+  previous_version_id TEXT, -- 이전 버전의 vault_id 참조
+  admin_override BOOLEAN NOT NULL DEFAULT 0, -- 향후 관리자 Override 기능용
+  deleted_at TIMESTAMP, -- 향후 Soft Delete 기능용
+  origin_source TEXT DEFAULT '{}', -- JSON 형식
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(agent_id, key, version)
+);
+
+-- Knowledge Vault 인덱스
+CREATE INDEX IF NOT EXISTS idx_knowledge_vault_agent_id ON knowledge_vault(agent_id);
+CREATE INDEX IF NOT EXISTS idx_knowledge_vault_key ON knowledge_vault(key);
+CREATE INDEX IF NOT EXISTS idx_knowledge_vault_version ON knowledge_vault(version);
+CREATE INDEX IF NOT EXISTS idx_knowledge_vault_deleted_at ON knowledge_vault(deleted_at);
+CREATE INDEX IF NOT EXISTS idx_knowledge_vault_agent_key ON knowledge_vault(agent_id, key);
+
+-- Knowledge Vault updated_at 자동 업데이트 트리거
+CREATE TRIGGER IF NOT EXISTS knowledge_vault_update_timestamp 
+AFTER UPDATE ON knowledge_vault
+BEGIN
+  UPDATE knowledge_vault 
+  SET updated_at = CURRENT_TIMESTAMP 
+  WHERE vault_id = NEW.vault_id;
+END;
+
 -- 초기 데이터 삽입 (선택사항)
 -- INSERT OR IGNORE INTO memory_item (id, type, content, importance, privacy_scope, pinned)
 -- VALUES ('welcome', 'semantic', 'Memento MCP Server에 오신 것을 환영합니다!', 1.0, 'private', TRUE);