memento-mcp-server 1.8.0 → 1.9.0

package/dist/services/core-memory-service.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Core Memory Service
+ * Core Memory에 대한 비즈니스 로직 처리
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: Core Memory 비즈니스 로직만 담당
+ * - 의존성 역전: Repository에 의존
+ * - 캐시 연동: always_load=true인 항목은 캐시에 유지
+ */
+import { CoreMemoryRepository, type CoreMemoryRecord } from '../repositories/core-memory-repository.js';
+export interface CoreMemoryCache {
+    /**
+     * 항목을 캐시에 저장
+     */
+    set(key: string, value: CoreMemoryRecord): void;
+    /**
+     * 캐시에서 항목 조회
+     */
+    get(key: string): CoreMemoryRecord | undefined;
+    /**
+     * 캐시에서 항목 삭제
+     */
+    delete(key: string): void;
+    /**
+     * 캐시 전체 조회 (always_load=true인 항목들)
+     */
+    getAll(): CoreMemoryRecord[];
+    /**
+     * 캐시 무효화
+     */
+    clear(): void;
+    /**
+     * 캐시 크기 반환
+     */
+    size(): number;
+}
+export interface CreateCoreMemoryServiceInput {
+    agent_id?: string;
+    key: string;
+    value: string;
+    always_load?: boolean;
+    origin_source?: string | null;
+}
+export interface UpdateCoreMemoryServiceInput {
+    value?: string;
+    always_load?: boolean;
+    origin_source?: string | null;
+}
+/**
+ * Core Memory Service
+ */
+export declare class CoreMemoryService {
+    private repository;
+    private cache;
+    constructor(repository: CoreMemoryRepository, cache?: CoreMemoryCache);
+    /**
+     * 캐시 서비스 설정
+     */
+    setCache(cache: CoreMemoryCache): void;
+    /**
+     * Core Memory 생성
+     */
+    create(input: CreateCoreMemoryServiceInput): Promise<CoreMemoryRecord>;
+    /**
+     * ID로 Core Memory 조회
+     */
+    findById(core_id: string): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id와 key로 Core Memory 조회 (캐시 우선)
+     */
+    findByKey(agent_id: string, key: string): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id로 모든 Core Memory 조회
+     */
+    findByAgentId(agent_id: string): Promise<CoreMemoryRecord[]>;
+    /**
+     * always_load=true인 Core Memory 조회 (캐시 우선)
+     */
+    findAlwaysLoad(agent_id?: string): Promise<CoreMemoryRecord[]>;
+    /**
+     * Core Memory 업데이트
+     */
+    update(core_id: string, input: UpdateCoreMemoryServiceInput): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id와 key로 Core Memory 업데이트
+     */
+    updateByKey(agent_id: string, key: string, input: UpdateCoreMemoryServiceInput): Promise<CoreMemoryRecord | null>;
+    /**
+     * Core Memory 삭제
+     */
+    delete(core_id: string): Promise<boolean>;
+    /**
+     * agent_id와 key로 Core Memory 삭제
+     */
+    deleteByKey(agent_id: string, key: string): Promise<boolean>;
+    /**
+     * agent_id로 모든 Core Memory 삭제
+     */
+    deleteByAgentId(agent_id: string): Promise<number>;
+    /**
+     * 모든 Core Memory 조회 (관리용)
+     */
+    findAll(): Promise<CoreMemoryRecord[]>;
+    /**
+     * Core Memory 개수 조회
+     */
+    count(agent_id?: string): Promise<number>;
+    /**
+     * 캐시 키 생성
+     */
+    private getCacheKey;
+    /**
+     * 캐시 무효화 및 재로드 (always_load=true인 항목들)
+     */
+    reloadCache(agent_id?: string): Promise<void>;
+}
+//# sourceMappingURL=core-memory-service.d.ts.map

package/dist/services/core-memory-service.d.ts.map

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

package/dist/services/core-memory-service.js

@@ -0,0 +1,247 @@
+/**
+ * Core Memory Service
+ * Core Memory에 대한 비즈니스 로직 처리
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: Core Memory 비즈니스 로직만 담당
+ * - 의존성 역전: Repository에 의존
+ * - 캐시 연동: always_load=true인 항목은 캐시에 유지
+ */
+import { CoreMemoryRepository } from '../repositories/core-memory-repository.js';
+/**
+ * Core Memory ID 생성 유틸리티
+ */
+function generateCoreId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 11);
+    return `core_${timestamp}_${random}`;
+}
+/**
+ * Core Memory Service
+ */
+export class CoreMemoryService {
+    repository;
+    cache = null;
+    constructor(repository, cache) {
+        this.repository = repository;
+        this.cache = cache || null;
+    }
+    /**
+     * 캐시 서비스 설정
+     */
+    setCache(cache) {
+        this.cache = cache;
+    }
+    /**
+     * Core Memory 생성
+     */
+    async create(input) {
+        const { agent_id = 'default', key, value, always_load = false, origin_source = null } = input;
+        // 기존 key가 있는지 확인 (UNIQUE 제약)
+        const existing = await this.repository.findByKey(agent_id, key);
+        if (existing) {
+            throw new Error(`Core memory with key '${key}' already exists for agent '${agent_id}'`);
+        }
+        const core_id = generateCoreId();
+        const record = await this.repository.create({
+            core_id,
+            agent_id,
+            key,
+            value,
+            always_load,
+            origin_source
+        });
+        // always_load=true인 경우 캐시에 추가
+        if (always_load && this.cache) {
+            this.cache.set(this.getCacheKey(agent_id, key), record);
+        }
+        return record;
+    }
+    /**
+     * ID로 Core Memory 조회
+     */
+    async findById(core_id) {
+        return this.repository.findById(core_id);
+    }
+    /**
+     * agent_id와 key로 Core Memory 조회 (캐시 우선)
+     */
+    async findByKey(agent_id, key) {
+        // 캐시에서 먼저 조회
+        if (this.cache) {
+            const cached = this.cache.get(this.getCacheKey(agent_id, key));
+            if (cached) {
+                return cached;
+            }
+        }
+        // 캐시에 없으면 DB에서 조회
+        const record = await this.repository.findByKey(agent_id, key);
+        // always_load=true이고 캐시에 없으면 캐시에 추가
+        if (record && record.always_load && this.cache) {
+            this.cache.set(this.getCacheKey(agent_id, key), record);
+        }
+        return record;
+    }
+    /**
+     * agent_id로 모든 Core Memory 조회
+     */
+    async findByAgentId(agent_id) {
+        return this.repository.findByAgentId(agent_id);
+    }
+    /**
+     * always_load=true인 Core Memory 조회 (캐시 우선)
+     */
+    async findAlwaysLoad(agent_id) {
+        // 캐시가 있고 캐시에 데이터가 있으면 캐시에서 조회
+        if (this.cache && this.cache.size() > 0) {
+            const cached = this.cache.getAll();
+            if (agent_id) {
+                return cached.filter(record => record.agent_id === agent_id);
+            }
+            return cached;
+        }
+        // 캐시가 없거나 비어있으면 DB에서 조회
+        const dbItems = await this.repository.findAlwaysLoad(agent_id);
+        // 캐시가 있으면 DB에서 조회한 항목들을 캐시에 로드
+        if (this.cache) {
+            for (const item of dbItems) {
+                const cacheKey = this.getCacheKey(item.agent_id, item.key);
+                this.cache.set(cacheKey, item);
+            }
+        }
+        return dbItems;
+    }
+    /**
+     * Core Memory 업데이트
+     */
+    async update(core_id, input) {
+        const existing = await this.repository.findById(core_id);
+        if (!existing) {
+            return null;
+        }
+        const updated = await this.repository.update(core_id, input);
+        if (!updated) {
+            return null;
+        }
+        // 캐시 업데이트
+        if (this.cache) {
+            const cacheKey = this.getCacheKey(updated.agent_id, updated.key);
+            if (updated.always_load) {
+                // always_load=true인 경우 캐시에 추가/업데이트
+                this.cache.set(cacheKey, updated);
+            }
+            else {
+                // always_load=false로 변경된 경우 캐시에서 제거
+                this.cache.delete(cacheKey);
+            }
+        }
+        return updated;
+    }
+    /**
+     * agent_id와 key로 Core Memory 업데이트
+     */
+    async updateByKey(agent_id, key, input) {
+        const existing = await this.repository.findByKey(agent_id, key);
+        if (!existing) {
+            return null;
+        }
+        const updated = await this.repository.updateByKey(agent_id, key, input);
+        if (!updated) {
+            return null;
+        }
+        // 캐시 업데이트
+        if (this.cache) {
+            const cacheKey = this.getCacheKey(agent_id, key);
+            if (updated.always_load) {
+                // always_load=true인 경우 캐시에 추가/업데이트
+                this.cache.set(cacheKey, updated);
+            }
+            else {
+                // always_load=false로 변경된 경우 캐시에서 제거
+                this.cache.delete(cacheKey);
+            }
+        }
+        return updated;
+    }
+    /**
+     * Core Memory 삭제
+     */
+    async delete(core_id) {
+        const existing = await this.repository.findById(core_id);
+        if (!existing) {
+            return false;
+        }
+        const deleted = await this.repository.delete(core_id);
+        // 캐시에서도 제거
+        if (deleted && this.cache) {
+            this.cache.delete(this.getCacheKey(existing.agent_id, existing.key));
+        }
+        return deleted;
+    }
+    /**
+     * agent_id와 key로 Core Memory 삭제
+     */
+    async deleteByKey(agent_id, key) {
+        const existing = await this.repository.findByKey(agent_id, key);
+        if (!existing) {
+            return false;
+        }
+        const deleted = await this.repository.deleteByKey(agent_id, key);
+        // 캐시에서도 제거
+        if (deleted && this.cache) {
+            this.cache.delete(this.getCacheKey(agent_id, key));
+        }
+        return deleted;
+    }
+    /**
+     * agent_id로 모든 Core Memory 삭제
+     */
+    async deleteByAgentId(agent_id) {
+        const deleted = await this.repository.deleteByAgentId(agent_id);
+        // 캐시에서도 제거
+        if (deleted > 0 && this.cache) {
+            // 캐시에서 해당 agent_id의 항목들 제거
+            const cached = this.cache.getAll();
+            for (const record of cached) {
+                if (record.agent_id === agent_id) {
+                    this.cache.delete(this.getCacheKey(agent_id, record.key));
+                }
+            }
+        }
+        return deleted;
+    }
+    /**
+     * 모든 Core Memory 조회 (관리용)
+     */
+    async findAll() {
+        return this.repository.findAll();
+    }
+    /**
+     * Core Memory 개수 조회
+     */
+    async count(agent_id) {
+        return this.repository.count(agent_id);
+    }
+    /**
+     * 캐시 키 생성
+     */
+    getCacheKey(agent_id, key) {
+        return `${agent_id}:${key}`;
+    }
+    /**
+     * 캐시 무효화 및 재로드 (always_load=true인 항목들)
+     */
+    async reloadCache(agent_id) {
+        if (!this.cache) {
+            return;
+        }
+        // 캐시 클리어
+        this.cache.clear();
+        // always_load=true인 항목들을 DB에서 조회하여 캐시에 로드
+        const alwaysLoadItems = await this.repository.findAlwaysLoad(agent_id);
+        for (const item of alwaysLoadItems) {
+            this.cache.set(this.getCacheKey(item.agent_id, item.key), item);
+        }
+    }
+}
+//# sourceMappingURL=core-memory-service.js.map

package/dist/services/core-memory-service.js.map

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

package/dist/services/knowledge-vault-service.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Knowledge Vault Service
+ * Knowledge Vault에 대한 비즈니스 로직 처리
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: Knowledge Vault 비즈니스 로직만 담당
+ * - 의존성 역전: Repository에 의존
+ * - Immutable 검증: immutable=true인 경우 업데이트/삭제 제한
+ * - 버전 관리: 기존 버전을 삭제하지 않고 새 버전 생성
+ */
+import { KnowledgeVaultRepository, type KnowledgeVaultRecord } from '../repositories/knowledge-vault-repository.js';
+export interface CreateKnowledgeVaultServiceInput {
+    agent_id?: string;
+    key: string;
+    value: string;
+    immutable?: boolean;
+    admin_override?: boolean;
+    origin_source?: string | null;
+}
+export interface UpdateKnowledgeVaultServiceInput {
+    value?: string;
+    immutable?: boolean;
+    admin_override?: boolean;
+    origin_source?: string | null;
+}
+/**
+ * Immutable 데이터 수정 시도 에러
+ */
+export declare class ImmutableDataError extends Error {
+    constructor(message: string);
+}
+/**
+ * Knowledge Vault Service
+ */
+export declare class KnowledgeVaultService {
+    private repository;
+    constructor(repository: KnowledgeVaultRepository);
+    /**
+     * Knowledge Vault 생성
+     * 기존 활성 버전이 있으면 새 버전으로 생성 (기존 버전은 유지)
+     */
+    create(input: CreateKnowledgeVaultServiceInput): Promise<KnowledgeVaultRecord>;
+    /**
+     * ID로 Knowledge Vault 조회
+     */
+    findById(vault_id: string): Promise<KnowledgeVaultRecord | null>;
+    /**
+     * agent_id와 key로 활성 버전 조회
+     */
+    findActiveByKey(agent_id: string, key: string): Promise<KnowledgeVaultRecord | null>;
+    /**
+     * agent_id와 key로 특정 버전 조회
+     */
+    findByKeyAndVersion(agent_id: string, key: string, version: number): Promise<KnowledgeVaultRecord | null>;
+    /**
+     * agent_id와 key로 모든 버전 조회
+     */
+    findAllVersionsByKey(agent_id: string, key: string): Promise<KnowledgeVaultRecord[]>;
+    /**
+     * agent_id로 모든 활성 Knowledge Vault 조회
+     */
+    findActiveByAgentId(agent_id: string): Promise<KnowledgeVaultRecord[]>;
+    /**
+     * agent_id로 모든 Knowledge Vault 조회 (삭제된 것 포함)
+     */
+    findByAgentId(agent_id: string): Promise<KnowledgeVaultRecord[]>;
+    /**
+     * Knowledge Vault 업데이트
+     * immutable=true인 경우 새 버전으로 생성 (기존 버전은 유지)
+     */
+    update(vault_id: string, input: UpdateKnowledgeVaultServiceInput): Promise<KnowledgeVaultRecord>;
+    /**
+     * agent_id와 key로 활성 버전 업데이트
+     * immutable=true인 경우 새 버전으로 생성
+     */
+    updateActiveByKey(agent_id: string, key: string, input: UpdateKnowledgeVaultServiceInput): Promise<KnowledgeVaultRecord>;
+    /**
+     * Knowledge Vault 삭제 (soft delete)
+     * immutable=true인 경우 삭제 불가
+     */
+    delete(vault_id: string): Promise<boolean>;
+    /**
+     * agent_id와 key로 활성 버전 삭제 (soft delete)
+     */
+    deleteActiveByKey(agent_id: string, key: string): Promise<boolean>;
+    /**
+     * 하드 삭제 (물리적 삭제, 주의 필요)
+     * immutable=true인 경우에도 강제 삭제 가능 (admin 권한 필요)
+     */
+    hardDelete(vault_id: string, force?: boolean): Promise<boolean>;
+    /**
+     * 모든 활성 Knowledge Vault 조회
+     */
+    findAllActive(): Promise<KnowledgeVaultRecord[]>;
+    /**
+     * 모든 Knowledge Vault 조회 (삭제된 것 포함)
+     */
+    findAll(): Promise<KnowledgeVaultRecord[]>;
+    /**
+     * Knowledge Vault 개수 조회
+     */
+    count(agent_id?: string, activeOnly?: boolean): Promise<number>;
+    /**
+     * Immutable 검증
+     * immutable=true인 경우 업데이트/삭제 가능 여부 확인
+     */
+    canUpdate(record: KnowledgeVaultRecord, admin_override?: boolean): boolean;
+    /**
+     * Immutable 검증
+     * immutable=true인 경우 삭제 가능 여부 확인
+     */
+    canDelete(record: KnowledgeVaultRecord, admin_override?: boolean): boolean;
+}
+//# sourceMappingURL=knowledge-vault-service.d.ts.map

package/dist/services/knowledge-vault-service.d.ts.map

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