memento-mcp-server 1.12.0 → 1.13.0-b

package/dist/utils/reflection-notes-normalize.js

@@ -0,0 +1,164 @@
+/**
+ * Reflection Notes JSON 정규화 유틸리티
+ *
+ * reflection_notes 필드를 FTS5 인덱싱을 위해 텍스트로 정규화하는 유틸리티 함수를 제공합니다.
+ * 트리거에서 사용되며, JSON 형식(단일 객체 또는 배열)을 FTS5 검색 가능한 텍스트로 변환합니다.
+ */
+/**
+ * 키 토큰으로 포함할 필드 목록
+ * 타입별 검색/필터링을 위해 중요한 키는 토큰으로 포함
+ */
+const KEY_TOKEN_FIELDS = ['failure_type', 'phase'];
+/**
+ * 제외할 필드 목록
+ * 검색에 불필요한 필드는 토큰화하지 않음
+ */
+const EXCLUDED_FIELDS = ['timestamp'];
+/**
+ * 키 토큰 접두사 매핑
+ * 키 앞에 접두사를 추가하여 키-값을 구분
+ */
+const KEY_TOKEN_PREFIXES = {
+    failure_type: 'type',
+    phase: 'phase'
+};
+/**
+ * 단일 Reflection Note 객체를 텍스트로 정규화
+ *
+ * 정규화 규칙:
+ * - 키 토큰 포함: failure_type, phase는 "key:value" 형식으로 포함
+ * - 값 필드 토큰화: 모든 값 필드를 추출하여 공백으로 구분
+ * - 제외 필드: timestamp는 제외
+ *
+ * @param note - 정규화할 Reflection Note 객체
+ * @returns 정규화된 텍스트 문자열
+ */
+function normalizeReflectionNoteObject(note) {
+    if (!note || typeof note !== 'object') {
+        return '';
+    }
+    const tokens = [];
+    // 키 토큰 포함 (failure_type, phase)
+    for (const key of KEY_TOKEN_FIELDS) {
+        if (note[key] !== undefined && note[key] !== null) {
+            const prefix = KEY_TOKEN_PREFIXES[key] || key;
+            const value = String(note[key]).trim();
+            if (value.length > 0) {
+                tokens.push(`${prefix}:${value}`);
+            }
+        }
+    }
+    // 값 필드 토큰화 (모든 값 필드 추출)
+    for (const [key, value] of Object.entries(note)) {
+        // 키 토큰 필드와 제외 필드는 이미 처리했거나 제외
+        if (KEY_TOKEN_FIELDS.includes(key) || EXCLUDED_FIELDS.includes(key)) {
+            continue;
+        }
+        // 값이 문자열인 경우 토큰화
+        if (typeof value === 'string' && value.trim().length > 0) {
+            tokens.push(value.trim());
+        }
+        // 값이 숫자나 불린인 경우 문자열로 변환
+        else if (typeof value === 'number' || typeof value === 'boolean') {
+            tokens.push(String(value));
+        }
+        // 값이 객체나 배열인 경우 재귀적으로 처리하지 않음 (현재 스키마에서는 단순 값만 사용)
+    }
+    return tokens.join(' ');
+}
+/**
+ * reflection_notes JSON을 FTS5 인덱싱을 위해 텍스트로 정규화
+ *
+ * 정규화 규칙:
+ * - 단일 객체: 모든 값 필드를 추출하여 공백으로 구분된 단일 문자열로 병합
+ * - 배열: 각 요소의 모든 값 필드를 추출하여 공백으로 구분된 단일 문자열로 병합
+ * - 키 토큰 포함: failure_type, phase는 "key:value" 형식으로 포함
+ * - 제외 필드: timestamp는 제외
+ *
+ * 예시:
+ * - `{"failure_type": "tool_error", "failure_description": "API timeout"}`
+ *   → "type:tool_error API timeout"
+ * - `[{"failure_description": "API timeout"}, {"lessons_learned": "retry needed"}]`
+ *   → "API timeout retry needed"
+ *
+ * @param reflectionNotes - 정규화할 reflection_notes (JSON 문자열, 객체, 또는 배열)
+ * @returns 정규화된 텍스트 문자열 (FTS5 인덱싱용)
+ */
+export function normalizeReflectionNotes(reflectionNotes) {
+    // NULL 또는 빈 값 처리
+    if (!reflectionNotes || reflectionNotes === '') {
+        return '';
+    }
+    // 문자열인 경우 JSON 파싱
+    let parsed;
+    if (typeof reflectionNotes === 'string') {
+        try {
+            parsed = JSON.parse(reflectionNotes);
+        }
+        catch (error) {
+            // JSON 파싱 실패 시 빈 문자열 반환
+            return '';
+        }
+    }
+    else {
+        parsed = reflectionNotes;
+    }
+    // 배열인 경우: 각 요소를 정규화하여 병합
+    if (Array.isArray(parsed)) {
+        const normalizedItems = parsed
+            .map(item => normalizeReflectionNoteObject(item))
+            .filter(text => text.length > 0);
+        return normalizedItems.join(' ');
+    }
+    // 단일 객체인 경우: 정규화
+    if (typeof parsed === 'object' && parsed !== null) {
+        return normalizeReflectionNoteObject(parsed);
+    }
+    // 예상치 못한 타입인 경우 빈 문자열 반환
+    return '';
+}
+/**
+ * 정규화된 텍스트에서 키 토큰 추출 (검색 쿼리 빌더용)
+ *
+ * @param normalizedText - 정규화된 텍스트
+ * @returns 키 토큰 배열 (예: ["type:tool_error", "phase:manual"])
+ */
+export function extractKeyTokens(normalizedText) {
+    const tokens = [];
+    const keyTokenPattern = /(type|phase):\w+/g;
+    let match;
+    while ((match = keyTokenPattern.exec(normalizedText)) !== null) {
+        tokens.push(match[0]);
+    }
+    return tokens;
+}
+/**
+ * 검색 쿼리 예시 생성 (문서화용)
+ *
+ * @returns 검색 쿼리 예시 객체
+ */
+export function getSearchQueryExamples() {
+    return [
+        {
+            description: 'tool_error 타입만 검색',
+            query: 'type:tool_error',
+            explanation: 'failure_type이 tool_error인 reflection_notes만 검색'
+        },
+        {
+            description: '특정 키워드 검색',
+            query: 'API timeout',
+            explanation: 'failure_description, lessons_learned 등에서 "API timeout" 검색'
+        },
+        {
+            description: '타입과 키워드 조합 검색',
+            query: 'type:tool_error API',
+            explanation: 'tool_error 타입이면서 "API"를 포함하는 reflection_notes 검색'
+        },
+        {
+            description: 'phase 필터링',
+            query: 'phase:auto',
+            explanation: 'phase가 auto인 reflection_notes만 검색'
+        }
+    ];
+}
+//# sourceMappingURL=reflection-notes-normalize.js.map

package/dist/utils/reflection-notes-normalize.js.map

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

package/dist/utils/reflection-notes-schema.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Reflection Notes JSON 스키마 검증 유틸리티
+ *
+ * reflection_notes 필드의 JSON 스키마를 검증하는 유틸리티 함수를 제공합니다.
+ * 단일 객체 또는 배열 형식 모두 지원합니다.
+ */
+import { z } from 'zod';
+/**
+ * Reflection Note 스키마 정의
+ *
+ * 필수 필드:
+ * - failure_type: 실패 유형 (tool_error | user_feedback | metric_failure)
+ * - failure_description: 실패에 대한 상세 설명 (최대 5000자)
+ * - timestamp: Reflexion 기록 시각 (ISO 8601 형식)
+ *
+ * 옵션 필드:
+ * - original_task: 원래 수행하려던 작업 (최대 2000자)
+ * - lessons_learned: 학습한 교훈 (최대 5000자)
+ * - suggested_improvements: 제안하는 개선 방안 (최대 5000자)
+ * - phase: 기록 방식 (manual | auto, 기본값: manual)
+ */
+export declare const ReflectionNoteSchema: z.ZodObject<{
+    failure_type: z.ZodEnum<["tool_error", "user_feedback", "metric_failure"]>;
+    failure_description: z.ZodString;
+    timestamp: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    original_task: z.ZodOptional<z.ZodString>;
+    lessons_learned: z.ZodOptional<z.ZodString>;
+    suggested_improvements: z.ZodOptional<z.ZodString>;
+    phase: z.ZodDefault<z.ZodEnum<["manual", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    failure_type: "tool_error" | "user_feedback" | "metric_failure";
+    phase: "auto" | "manual";
+    timestamp: string;
+    failure_description: string;
+    original_task?: string | undefined;
+    lessons_learned?: string | undefined;
+    suggested_improvements?: string | undefined;
+}, {
+    failure_type: "tool_error" | "user_feedback" | "metric_failure";
+    timestamp: string;
+    failure_description: string;
+    phase?: "auto" | "manual" | undefined;
+    original_task?: string | undefined;
+    lessons_learned?: string | undefined;
+    suggested_improvements?: string | undefined;
+}>;
+/**
+ * Reflection Note 타입 정의
+ */
+export type ReflectionNote = z.infer<typeof ReflectionNoteSchema>;
+/**
+ * 검증 결과 타입
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors?: Array<{
+        field: string;
+        expected: string;
+        actual: any;
+        message: string;
+    }>;
+}
+/**
+ * 단일 Reflection Note 객체 검증
+ *
+ * @param data - 검증할 객체
+ * @returns 검증 결과
+ */
+export declare function validateReflectionNote(data: unknown): ValidationResult;
+/**
+ * 단일 객체 또는 배열 형식 모두 지원하는 검증 함수
+ *
+ * @param jsonString - 검증할 JSON 문자열
+ * @returns 검증 결과
+ */
+export declare function validateReflectionNotes(jsonString: string): ValidationResult;
+/**
+ * 검증 결과를 사람이 읽기 쉬운 에러 메시지로 변환
+ *
+ * @param result - 검증 결과
+ * @returns 에러 메시지 문자열
+ */
+export declare function formatValidationErrors(result: ValidationResult): string;
+//# sourceMappingURL=reflection-notes-schema.d.ts.map

package/dist/utils/reflection-notes-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-notes-schema.d.ts","sourceRoot":"","sources":["../../src/utils/reflection-notes-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAmD/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,GAAG,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CA+BtE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAoF5E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAavE"}

package/dist/utils/reflection-notes-schema.js

@@ -0,0 +1,215 @@
+/**
+ * Reflection Notes JSON 스키마 검증 유틸리티
+ *
+ * reflection_notes 필드의 JSON 스키마를 검증하는 유틸리티 함수를 제공합니다.
+ * 단일 객체 또는 배열 형식 모두 지원합니다.
+ */
+import { z } from 'zod';
+/**
+ * ISO 8601 형식의 날짜 문자열 검증
+ * 예: "2025-01-01T00:00:00Z", "2025-01-01T00:00:00.000Z"
+ */
+const iso8601Regex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/;
+/**
+ * Reflection Note 스키마 정의
+ *
+ * 필수 필드:
+ * - failure_type: 실패 유형 (tool_error | user_feedback | metric_failure)
+ * - failure_description: 실패에 대한 상세 설명 (최대 5000자)
+ * - timestamp: Reflexion 기록 시각 (ISO 8601 형식)
+ *
+ * 옵션 필드:
+ * - original_task: 원래 수행하려던 작업 (최대 2000자)
+ * - lessons_learned: 학습한 교훈 (최대 5000자)
+ * - suggested_improvements: 제안하는 개선 방안 (최대 5000자)
+ * - phase: 기록 방식 (manual | auto, 기본값: manual)
+ */
+export const ReflectionNoteSchema = z.object({
+    failure_type: z.enum(['tool_error', 'user_feedback', 'metric_failure'], {
+        errorMap: (issue, ctx) => {
+            if (issue.code === z.ZodIssueCode.invalid_enum_value) {
+                return {
+                    message: `failure_type는 'tool_error', 'user_feedback', 'metric_failure' 중 하나여야 합니다. 현재 값: ${ctx.data}`
+                };
+            }
+            return { message: ctx.defaultError };
+        }
+    }),
+    failure_description: z.string()
+        .min(1, 'failure_description은 비어있을 수 없습니다')
+        .max(5000, 'failure_description은 최대 5000자를 초과할 수 없습니다'),
+    timestamp: z.string()
+        .min(1, 'timestamp는 필수입니다')
+        .refine((val) => iso8601Regex.test(val), {
+        message: 'timestamp는 ISO 8601 형식이어야 합니다 (예: 2025-01-01T00:00:00Z)'
+    })
+        .refine((val) => {
+        // 실제로 유효한 날짜인지 확인
+        const date = new Date(val);
+        return !isNaN(date.getTime());
+    }, {
+        message: 'timestamp는 유효한 날짜여야 합니다'
+    }),
+    original_task: z.string()
+        .max(2000, 'original_task는 최대 2000자를 초과할 수 없습니다')
+        .optional(),
+    lessons_learned: z.string()
+        .max(5000, 'lessons_learned는 최대 5000자를 초과할 수 없습니다')
+        .optional(),
+    suggested_improvements: z.string()
+        .max(5000, 'suggested_improvements는 최대 5000자를 초과할 수 없습니다')
+        .optional(),
+    phase: z.enum(['manual', 'auto'], {
+        errorMap: (issue, ctx) => {
+            if (issue.code === z.ZodIssueCode.invalid_enum_value) {
+                return {
+                    message: `phase는 'manual' 또는 'auto'여야 합니다. 현재 값: ${ctx.data}`
+                };
+            }
+            return { message: ctx.defaultError };
+        }
+    }).default('manual')
+});
+/**
+ * 단일 Reflection Note 객체 검증
+ *
+ * @param data - 검증할 객체
+ * @returns 검증 결과
+ */
+export function validateReflectionNote(data) {
+    try {
+        ReflectionNoteSchema.parse(data);
+        return { isValid: true };
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.errors.map((err) => {
+                const path = err.path.join('.');
+                return {
+                    field: path || 'root',
+                    expected: err.code === z.ZodIssueCode.invalid_enum_value
+                        ? `enum 값 중 하나 (${err.options?.join(', ')})`
+                        : err.code === z.ZodIssueCode.invalid_type
+                            ? err.expected
+                            : '유효한 값',
+                    actual: err.path.length > 0 ? err.path.reduce((obj, key) => obj?.[key], data) : data,
+                    message: err.message
+                };
+            });
+            return { isValid: false, errors };
+        }
+        return {
+            isValid: false,
+            errors: [{
+                    field: 'root',
+                    expected: '유효한 Reflection Note 객체',
+                    actual: data,
+                    message: error instanceof Error ? error.message : String(error)
+                }]
+        };
+    }
+}
+/**
+ * 단일 객체 또는 배열 형식 모두 지원하는 검증 함수
+ *
+ * @param jsonString - 검증할 JSON 문자열
+ * @returns 검증 결과
+ */
+export function validateReflectionNotes(jsonString) {
+    if (!jsonString || jsonString.trim() === '') {
+        return {
+            isValid: false,
+            errors: [{
+                    field: 'root',
+                    expected: '비어있지 않은 JSON 문자열',
+                    actual: jsonString,
+                    message: 'reflection_notes는 빈 문자열일 수 없습니다'
+                }]
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonString);
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            errors: [{
+                    field: 'root',
+                    expected: '유효한 JSON 형식',
+                    actual: jsonString,
+                    message: `JSON 파싱 실패: ${error instanceof Error ? error.message : String(error)}`
+                }]
+        };
+    }
+    // 배열인 경우
+    if (Array.isArray(parsed)) {
+        if (parsed.length === 0) {
+            return {
+                isValid: false,
+                errors: [{
+                        field: 'root',
+                        expected: '최소 1개 이상의 요소를 포함한 배열',
+                        actual: parsed,
+                        message: 'reflection_notes 배열은 최소 1개 이상의 요소를 포함해야 합니다'
+                    }]
+            };
+        }
+        // 배열의 각 요소 검증
+        const allErrors = [];
+        parsed.forEach((item, index) => {
+            const result = validateReflectionNote(item);
+            if (!result.isValid && result.errors) {
+                // 인덱스를 필드 경로에 추가
+                result.errors.forEach((err) => {
+                    allErrors.push({
+                        field: `[${index}].${err.field}`,
+                        expected: err.expected,
+                        actual: err.actual,
+                        message: err.message
+                    });
+                });
+            }
+        });
+        if (allErrors.length > 0) {
+            return {
+                isValid: false,
+                errors: allErrors
+            };
+        }
+        return { isValid: true };
+    }
+    // 단일 객체인 경우
+    if (typeof parsed === 'object' && parsed !== null) {
+        return validateReflectionNote(parsed);
+    }
+    // 객체나 배열이 아닌 경우
+    return {
+        isValid: false,
+        errors: [{
+                field: 'root',
+                expected: 'JSON 객체 또는 배열',
+                actual: typeof parsed,
+                message: `reflection_notes는 JSON 객체 또는 배열이어야 합니다. 현재 타입: ${typeof parsed}`
+            }]
+    };
+}
+/**
+ * 검증 결과를 사람이 읽기 쉬운 에러 메시지로 변환
+ *
+ * @param result - 검증 결과
+ * @returns 에러 메시지 문자열
+ */
+export function formatValidationErrors(result) {
+    if (result.isValid || !result.errors) {
+        return '';
+    }
+    const messages = result.errors.map((err) => {
+        const actualStr = typeof err.actual === 'object'
+            ? JSON.stringify(err.actual).substring(0, 100)
+            : String(err.actual).substring(0, 100);
+        return `필드 '${err.field}': ${err.message} (기대값: ${err.expected}, 실제값: ${actualStr})`;
+    });
+    return messages.join('\n');
+}
+//# sourceMappingURL=reflection-notes-schema.js.map

package/dist/utils/reflection-notes-schema.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp-server",
-  "version": "1.12.0",
+  "version": "1.13.0-b",
   "description": "AI Agent 기억 보조 MCP 서버 - 사람의 기억 구조를 모사한 스토리지+검색+요약+망각 메커니즘",
   "main": "dist/server/index.js",
   "type": "module",
@@ -21,6 +21,8 @@
     "start:http-v2": "node dist/server/http-server-v2.js",
     "test": "vitest",
     "test:ci": "vitest --run --reporter=basic",
+    "test:vector-search-quality": "vitest --run src/test/test-vector-search-quality-with-consolidation.spec.ts",
+    "test:vector-search-quality:ci": "vitest --run --reporter=junit --reporter=json --outputFile.junit=./test-results/vector-search-quality-junit.xml --outputFile.json=./test-results/vector-search-quality-results.json src/test/test-vector-search-quality-with-consolidation.spec.ts",
     "lint": "eslint src/**/*.ts",
     "type-check": "tsc --noEmit",
     "db:init": "tsx src/database/init.ts",

package/src/database/schema.sql

@@ -98,26 +98,28 @@ CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts USING fts5(
   content,
   tags,
   source,
+  reflection_notes,
   content='memory_item',
   content_rowid='rowid'
 );
 
--- FTS5 트리거 (자동 동기화)
+-- FTS5 트리거 (자동 동기화, reflection_notes 정규화 포함)
+-- Note: normalize_reflection_notes 함수는 데이터베이스 초기화 시 등록되어야 함
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_insert AFTER INSERT ON memory_item BEGIN
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
+  INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+  VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
 END;
 
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_delete AFTER DELETE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
 END;
 
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_update AFTER UPDATE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+  INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+  VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
 END;
 
 -- 임베딩 저장 테이블 (다중 제공자/차원 지원)