memento-mcp-server 1.11.1 → 1.12.0-a

package/dist/utils/relation-visualizer.js

@@ -0,0 +1,239 @@
+/**
+ * 관계 그래프 시각화 유틸리티
+ * 텍스트 기반으로 관계 그래프를 시각화합니다.
+ */
+/**
+ * 관계 그래프 시각화 유틸리티 클래스
+ */
+export class RelationVisualizer {
+    /**
+     * 관계 목록을 텍스트로 시각화
+     *
+     * @param relations 관계 목록
+     * @param options 시각화 옵션
+     * @returns 시각화된 텍스트
+     */
+    static visualizeAsText(relations, options = {}) {
+        const { showMemoryIds = true, showConfidence = true, showRelationTypes = true, indent = '  ', arrow = '-->' } = options;
+        if (relations.length === 0) {
+            return '관계가 없습니다.';
+        }
+        const lines = [];
+        const visited = new Set();
+        for (const relation of relations) {
+            const key = `${relation.source_id}-${relation.target_id}-${relation.relation_type}`;
+            if (visited.has(key)) {
+                continue;
+            }
+            visited.add(key);
+            const parts = [];
+            // 소스 메모리 ID
+            if (showMemoryIds) {
+                parts.push(relation.source_id);
+            }
+            // 화살표 및 관계 유형
+            if (showRelationTypes) {
+                parts.push(`${arrow}[${relation.relation_type}]`);
+            }
+            else {
+                parts.push(arrow);
+            }
+            // 타겟 메모리 ID
+            if (showMemoryIds) {
+                parts.push(relation.target_id);
+            }
+            // 신뢰도
+            if (showConfidence) {
+                parts.push(`(confidence: ${relation.confidence.toFixed(2)})`);
+            }
+            lines.push(indent + parts.join(' '));
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 서브그래프를 시각화 (특정 메모리를 중심으로)
+     *
+     * @param centerMemoryId 중심 메모리 ID
+     * @param relations 관계 목록
+     * @param options 시각화 옵션
+     * @returns 시각화된 텍스트
+     */
+    static visualizeSubgraph(centerMemoryId, relations, options = {}) {
+        const { maxDepth = 2, minConfidence = 0.0, relationTypes, showMemoryIds = true, showConfidence = true, showRelationTypes = true, indent = '  ', arrow = '-->' } = options;
+        // 필터링: 신뢰도 및 관계 유형
+        let filteredRelations = relations.filter(r => r.confidence >= minConfidence);
+        if (relationTypes && relationTypes.length > 0) {
+            filteredRelations = filteredRelations.filter(r => relationTypes.includes(r.relation_type));
+        }
+        if (filteredRelations.length === 0) {
+            return `중심 메모리: ${centerMemoryId}\n관계가 없습니다.`;
+        }
+        // 그래프 구조 생성 (BFS 방식)
+        const graph = new Map();
+        const reverseGraph = new Map();
+        for (const relation of filteredRelations) {
+            // Outgoing 관계
+            if (!graph.has(relation.source_id)) {
+                graph.set(relation.source_id, []);
+            }
+            graph.get(relation.source_id).push({
+                target: relation.target_id,
+                relation
+            });
+            // Incoming 관계
+            if (!reverseGraph.has(relation.target_id)) {
+                reverseGraph.set(relation.target_id, []);
+            }
+            reverseGraph.get(relation.target_id).push({
+                source: relation.source_id,
+                relation
+            });
+        }
+        // BFS로 서브그래프 탐색
+        const visited = new Set();
+        const queue = [];
+        const result = [];
+        queue.push({ memoryId: centerMemoryId, depth: 0, path: [] });
+        visited.add(centerMemoryId);
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (current.depth > 0) {
+                // 중심 메모리가 아닌 경우 결과에 추가
+                result.push({
+                    memoryId: current.memoryId,
+                    depth: current.depth,
+                    path: current.path,
+                    relation: null // path에서 관계 정보 추출 가능
+                });
+            }
+            if (current.depth >= maxDepth) {
+                continue;
+            }
+            // Outgoing 관계 탐색
+            const outgoing = graph.get(current.memoryId) || [];
+            for (const { target, relation } of outgoing) {
+                if (!visited.has(target)) {
+                    visited.add(target);
+                    queue.push({
+                        memoryId: target,
+                        depth: current.depth + 1,
+                        path: [...current.path, `${current.memoryId}--[${relation.relation_type}]-->${target}`]
+                    });
+                }
+            }
+            // Incoming 관계 탐색
+            const incoming = reverseGraph.get(current.memoryId) || [];
+            for (const { source, relation } of incoming) {
+                if (!visited.has(source)) {
+                    visited.add(source);
+                    queue.push({
+                        memoryId: source,
+                        depth: current.depth + 1,
+                        path: [...current.path, `${source}--[${relation.relation_type}]-->${current.memoryId}`]
+                    });
+                }
+            }
+        }
+        // 시각화 텍스트 생성
+        const lines = [];
+        lines.push(`중심 메모리: ${centerMemoryId}`);
+        lines.push('');
+        // 깊이별로 그룹화하여 출력
+        const depthGroups = new Map();
+        for (const item of result) {
+            if (!depthGroups.has(item.depth)) {
+                depthGroups.set(item.depth, []);
+            }
+            depthGroups.get(item.depth).push(item);
+        }
+        // 관계 정보 추출 및 표시
+        const relationMap = new Map();
+        for (const relation of filteredRelations) {
+            const key = `${relation.source_id}-${relation.target_id}-${relation.relation_type}`;
+            relationMap.set(key, relation);
+        }
+        for (let depth = 1; depth <= maxDepth; depth++) {
+            const items = depthGroups.get(depth) || [];
+            if (items.length === 0) {
+                continue;
+            }
+            lines.push(`[${depth}-hop 관계]`);
+            for (const item of items) {
+                // path에서 마지막 관계 정보 추출
+                const lastPath = item.path[item.path.length - 1];
+                if (lastPath) {
+                    const match = lastPath.match(/^(.+?)--\[(.+?)\]-->(.+?)$/);
+                    if (match && match[1] && match[2] && match[3]) {
+                        const [, source, relationType, target] = match;
+                        const key = `${source}-${target}-${relationType}`;
+                        const relation = relationMap.get(key);
+                        const parts = [];
+                        parts.push(indent.repeat(depth));
+                        if (showMemoryIds) {
+                            parts.push(source);
+                        }
+                        if (showRelationTypes) {
+                            parts.push(`${arrow}[${relationType}]`);
+                        }
+                        else {
+                            parts.push(arrow);
+                        }
+                        if (showMemoryIds) {
+                            parts.push(target);
+                        }
+                        if (showConfidence && relation) {
+                            parts.push(`(confidence: ${relation.confidence.toFixed(2)})`);
+                        }
+                        lines.push(parts.join(' '));
+                    }
+                    else {
+                        // path 파싱 실패 시 간단히 표시
+                        lines.push(indent.repeat(depth) + item.memoryId);
+                    }
+                }
+            }
+            lines.push('');
+        }
+        if (result.length === 0) {
+            lines.push('관계가 없습니다.');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 관계 목록을 간단한 텍스트 형식으로 시각화
+     *
+     * @param relations 관계 목록
+     * @returns 시각화된 텍스트
+     */
+    static visualizeSimple(relations) {
+        if (relations.length === 0) {
+            return '관계가 없습니다.';
+        }
+        const lines = [];
+        for (const relation of relations) {
+            lines.push(`${relation.source_id} --[${relation.relation_type}]--> ${relation.target_id} (confidence: ${relation.confidence.toFixed(2)})`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 관계 목록을 JSON 형식으로 시각화
+     *
+     * @param relations 관계 목록
+     * @param pretty JSON 포맷팅 여부 (기본값: true)
+     * @returns JSON 문자열
+     */
+    static visualizeAsJSON(relations, pretty = true) {
+        const data = relations.map(r => ({
+            id: r.id,
+            source_id: r.source_id,
+            target_id: r.target_id,
+            relation_type: r.relation_type,
+            confidence: r.confidence,
+            created_at: r.created_at.toISOString(),
+            updated_at: r.updated_at.toISOString(),
+            metadata: r.metadata
+        }));
+        return pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+    }
+}
+//# sourceMappingURL=relation-visualizer.js.map

package/dist/utils/relation-visualizer.js.map

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

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 타입 가드 유틸리티
+ * 데이터베이스 조회 결과의 타입 안전성을 보장하기 위한 타입 가드 함수들
+ */
+import type { MemoryType, PrivacyScope, MemoryItem } from '../types/index.js';
+/**
+ * 데이터베이스에서 조회한 메모리 행 타입
+ */
+export interface MemoryRow {
+    id: string;
+    type: string;
+    content: string;
+    importance: number;
+    privacy_scope: string;
+    created_at: string;
+    updated_at?: string;
+    last_accessed?: string;
+    pinned?: number | boolean;
+    tags?: string | null;
+    source?: string | null;
+    embedding?: string | null;
+}
+/**
+ * 타입 가드: MemoryRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MemoryRow 여부
+ */
+export declare function isMemoryRow(value: unknown): value is MemoryRow;
+/**
+ * 타입 가드: MemoryType인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MemoryType 여부
+ */
+export declare function isMemoryType(value: string): value is MemoryType;
+/**
+ * 타입 가드: PrivacyScope인지 확인
+ *
+ * @param value 확인할 값
+ * @returns PrivacyScope 여부
+ */
+export declare function isPrivacyScope(value: string): value is PrivacyScope;
+/**
+ * MemoryRow를 MemoryItem으로 변환
+ * 타입 안전성을 보장하며 변환합니다.
+ *
+ * @param row 데이터베이스 행
+ * @returns MemoryItem 또는 null (타입 검증 실패 시)
+ */
+export declare function convertMemoryRowToItem(row: MemoryRow): MemoryItem | null;
+/**
+ * 관계 행 타입
+ */
+export interface RelationRow {
+    id: number;
+    source_id: string;
+    target_id: string;
+    relation_type: string;
+    confidence: number;
+    created_at: string;
+    updated_at: string;
+    metadata: string | null;
+}
+/**
+ * 타입 가드: RelationRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns RelationRow 여부
+ */
+export declare function isRelationRow(value: unknown): value is RelationRow;
+/**
+ * 기존 관계 행 타입
+ */
+export interface ExistingRelationRow {
+    id: number;
+    confidence: number;
+    metadata: string | null;
+}
+/**
+ * 타입 가드: ExistingRelationRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns ExistingRelationRow 여부
+ */
+export declare function isExistingRelationRow(value: unknown): value is ExistingRelationRow;
+/**
+ * 메타데이터 행 타입
+ */
+export interface MetadataRow {
+    metadata: string | null;
+}
+/**
+ * 타입 가드: MetadataRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MetadataRow 여부
+ */
+export declare function isMetadataRow(value: unknown): value is MetadataRow;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAa9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAgDxE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAelE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAUlF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE"}

package/dist/utils/type-guards.js

@@ -0,0 +1,144 @@
+/**
+ * 타입 가드 유틸리티
+ * 데이터베이스 조회 결과의 타입 안전성을 보장하기 위한 타입 가드 함수들
+ */
+/**
+ * 타입 가드: MemoryRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MemoryRow 여부
+ */
+export function isMemoryRow(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const row = value;
+    return (typeof row.id === 'string' &&
+        typeof row.type === 'string' &&
+        typeof row.content === 'string' &&
+        typeof row.importance === 'number' &&
+        typeof row.privacy_scope === 'string' &&
+        typeof row.created_at === 'string');
+}
+/**
+ * 타입 가드: MemoryType인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MemoryType 여부
+ */
+export function isMemoryType(value) {
+    return value === 'working' || value === 'episodic' || value === 'semantic' || value === 'procedural';
+}
+/**
+ * 타입 가드: PrivacyScope인지 확인
+ *
+ * @param value 확인할 값
+ * @returns PrivacyScope 여부
+ */
+export function isPrivacyScope(value) {
+    return value === 'private' || value === 'team' || value === 'public';
+}
+/**
+ * MemoryRow를 MemoryItem으로 변환
+ * 타입 안전성을 보장하며 변환합니다.
+ *
+ * @param row 데이터베이스 행
+ * @returns MemoryItem 또는 null (타입 검증 실패 시)
+ */
+export function convertMemoryRowToItem(row) {
+    // 타입 검증
+    if (!isMemoryType(row.type)) {
+        return null;
+    }
+    if (!isPrivacyScope(row.privacy_scope)) {
+        return null;
+    }
+    // embedding 파싱 (JSON 배열 문자열인 경우)
+    let embedding;
+    if (row.embedding) {
+        try {
+            const parsed = JSON.parse(row.embedding);
+            if (Array.isArray(parsed) && parsed.every(v => typeof v === 'number')) {
+                embedding = parsed;
+            }
+        }
+        catch {
+            // 파싱 실패 시 무시
+        }
+    }
+    // tags 파싱 (JSON 배열 문자열인 경우)
+    let tags;
+    if (row.tags) {
+        try {
+            const parsed = JSON.parse(row.tags);
+            if (Array.isArray(parsed) && parsed.every(v => typeof v === 'string')) {
+                tags = parsed;
+            }
+        }
+        catch {
+            // 파싱 실패 시 무시
+        }
+    }
+    return {
+        id: row.id,
+        type: row.type,
+        content: row.content,
+        importance: row.importance,
+        privacy_scope: row.privacy_scope,
+        created_at: new Date(row.created_at),
+        last_accessed: row.last_accessed ? new Date(row.last_accessed) : undefined,
+        pinned: typeof row.pinned === 'boolean' ? row.pinned : Boolean(row.pinned),
+        tags,
+        source: row.source || undefined,
+        embedding
+    };
+}
+/**
+ * 타입 가드: RelationRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns RelationRow 여부
+ */
+export function isRelationRow(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const row = value;
+    return (typeof row.id === 'number' &&
+        typeof row.source_id === 'string' &&
+        typeof row.target_id === 'string' &&
+        typeof row.relation_type === 'string' &&
+        typeof row.confidence === 'number' &&
+        typeof row.created_at === 'string' &&
+        typeof row.updated_at === 'string' &&
+        (row.metadata === null || typeof row.metadata === 'string'));
+}
+/**
+ * 타입 가드: ExistingRelationRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns ExistingRelationRow 여부
+ */
+export function isExistingRelationRow(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const row = value;
+    return (typeof row.id === 'number' &&
+        typeof row.confidence === 'number' &&
+        (row.metadata === null || typeof row.metadata === 'string'));
+}
+/**
+ * 타입 가드: MetadataRow인지 확인
+ *
+ * @param value 확인할 값
+ * @returns MetadataRow 여부
+ */
+export function isMetadataRow(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const row = value;
+    return row.metadata === null || typeof row.metadata === 'string';
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp-server",
-  "version": "1.11.1",
+  "version": "1.12.0-a",
   "description": "AI Agent 기억 보조 MCP 서버 - 사람의 기억 구조를 모사한 스토리지+검색+요약+망각 메커니즘",
   "main": "dist/server/index.js",
   "type": "module",
@@ -27,6 +27,8 @@
     "db:migrate": "tsx src/database/migrate.ts",
     "db:check-migration": "tsx src/scripts/check-migration-status.ts",
     "db:check-migration:help": "echo 'Usage: npm run db:check-migration [database-path]'",
+    "generate-relation-report": "tsx scripts/generate-relation-report.ts",
+    "weekly-relation-validation": "tsx scripts/weekly-relation-validation.ts",
     "test:client": "tsx src/test/test-client.ts",
     "test:http-v2": "tsx src/test/test-http-server-v2.ts",
     "test:search": "tsx src/test/test-search.ts",
@@ -89,6 +91,7 @@
   "dependencies": {
     "@google/genai": "^1.21.0",
     "@google/generative-ai": "^0.24.1",
+    "@iarna/toml": "^2.2.5",
     "@modelcontextprotocol/sdk": "^1.18.2",
     "@xenova/transformers": "^2.17.2",
     "axios": "^1.12.2",
@@ -121,8 +124,10 @@
     "vitest": "^1.0.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
   },
+  "packageManager": "npm@>=10.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jee1/memento.git"