memento-mcp-server 1.13.1-a4 → 1.14.0-C

package/dist/database/schema.sql

@@ -20,7 +20,11 @@ CREATE TABLE IF NOT EXISTS memory_item (
   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 형식
+  reflection_notes TEXT, -- Procedural Memory 전용, JSON 형식
+  -- Procedural Memory Enhancement (v7.0) 추가 필드
+  workflow_name TEXT, -- 프로세스 이름 (예: "데이터 마이그레이션", "API 배포")
+  skill_name TEXT, -- 기술/능력 이름 (예: "스키마 백업", "데이터 검증")
+  trigger_conditions TEXT -- 트리거 조건 (JSON 객체 문자열)
 );
 
 -- 태그 테이블
@@ -45,7 +49,7 @@ CREATE TABLE IF NOT EXISTS memory_link (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   source_id TEXT NOT NULL,
   target_id TEXT NOT NULL,
-  relation_type TEXT CHECK (relation_type IN ('cause_of', 'derived_from', 'duplicates', 'contradicts')) NOT NULL,
+  relation_type TEXT CHECK (relation_type IN ('cause_of', 'derived_from', 'duplicates', 'contradicts', 'version_of')) NOT NULL,
   created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
   FOREIGN KEY (source_id) REFERENCES memory_item(id) ON DELETE CASCADE,
   FOREIGN KEY (target_id) REFERENCES memory_item(id) ON DELETE CASCADE,
@@ -80,6 +84,9 @@ CREATE INDEX IF NOT EXISTS idx_memory_item_privacy_scope ON memory_item(privacy_
 CREATE INDEX IF NOT EXISTS idx_memory_item_importance ON memory_item(importance);
 CREATE INDEX IF NOT EXISTS idx_memory_item_user_id ON memory_item(id); -- user_id 대신 id 사용
 CREATE INDEX IF NOT EXISTS idx_memory_item_project_id ON memory_item(id); -- project_id 대신 id 사용
+-- Procedural Memory Enhancement (v7.0) 인덱스
+CREATE INDEX IF NOT EXISTS idx_memory_item_workflow_name ON memory_item(workflow_name);
+CREATE INDEX IF NOT EXISTS idx_memory_item_skill_name ON memory_item(skill_name);
 
 CREATE INDEX IF NOT EXISTS idx_memory_tag_memory_id ON memory_item_tag(memory_id);
 CREATE INDEX IF NOT EXISTS idx_memory_tag_tag_id ON memory_item_tag(tag_id);

package/dist/domains/memory/tools/recall-tool.d.ts

@@ -4,9 +4,177 @@
  */
 import { BaseTool } from '../../../tools/base-tool.js';
 import type { ToolContext, ToolResult } from '../../../tools/types.js';
+/**
+ * 앵커 설정 메타데이터 타입
+ */
+export interface AnchorSetMetadata {
+    memory_id: string;
+    slot: 'A';
+    agent_id: string;
+}
+/**
+ * 이웃 기억 항목 타입
+ */
+export interface NeighborMemoryItem {
+    id: string;
+    content: string;
+    similarity: number;
+    [key: string]: any;
+}
+/**
+ * Recall 응답 항목 타입 (neighbors 필드 포함)
+ *
+ * @property neighbors - 이웃 기억 배열 (optional)
+ *   - include_neighbors=true이고 상위 neighbors_limit개 결과에만 포함됨
+ *   - neighbors_limit보다 많은 결과는 neighbors 필드가 없음 (undefined)
+ *   - 이웃 기억 조회 실패 시 빈 배열 []로 설정됨
+ */
+export interface RecallResultItem {
+    memory_id: string;
+    id?: string;
+    content: string;
+    type: string;
+    importance: number;
+    created_at: string;
+    final_score: number;
+    neighbors?: NeighborMemoryItem[];
+    [key: string]: any;
+}
+/**
+ * Recall 응답 메타데이터 타입
+ *
+ * @property anchor_set - 앵커 설정 정보 (auto_set_anchor=true일 때만 설정)
+ *   - 성공 시: {memory_id, slot: "A", agent_id} 객체
+ *   - 실패/건너뜀/비활성화 시: null
+ * @property anchor_set_error - 앵커 설정 실패 여부 (optional)
+ *   - anchor_set=null이고 anchor_set_error=true: 앵커 설정 실패
+ * @property anchor_set_skipped - 앵커 설정 건너뜀 여부 (optional)
+ *   - anchor_set=null이고 anchor_set_skipped=true: 앵커 설정 건너뜀 (pinned 앵커 보호 등)
+ * @property anchor_set_skipped_reason - 앵커 설정 건너뜀 사유 (optional)
+ *   - "pinned_anchor_protected": 슬롯 A에 pinned 앵커가 있어서 보호됨
+ */
+export interface RecallResponseMetadata {
+    anchor_set: AnchorSetMetadata | null;
+    anchor_set_error?: boolean;
+    anchor_set_skipped?: boolean;
+    anchor_set_skipped_reason?: string;
+    [key: string]: any;
+}
+/**
+ * Recall 응답 타입
+ *
+ * @example 앵커 설정 성공 + 이웃 기억 포함
+ * ```json
+ * {
+ *   "items": [
+ *     {
+ *       "memory_id": "mem_12345",
+ *       "content": "검색 결과 내용",
+ *       "type": "episodic",
+ *       "importance": 0.8,
+ *       "created_at": "2024-01-01T00:00:00Z",
+ *       "final_score": 0.95,
+ *       "neighbors": [
+ *         {
+ *           "id": "mem_67890",
+ *           "content": "관련 기억 내용",
+ *           "similarity": 0.85
+ *         }
+ *       ]
+ *     },
+ *     {
+ *       "memory_id": "mem_11111",
+ *       "content": "두 번째 결과",
+ *       "neighbors": []
+ *     },
+ *     {
+ *       "memory_id": "mem_22222",
+ *       "content": "세 번째 결과 (neighbors_limit 초과로 neighbors 필드 없음)"
+ *     }
+ *   ],
+ *   "total_count": 3,
+ *   "query_time": 150,
+ *   "search_type": "hybrid",
+ *   "metadata": {
+ *     "anchor_set": {
+ *       "memory_id": "mem_12345",
+ *       "slot": "A",
+ *       "agent_id": "default"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example 앵커 설정 실패
+ * ```json
+ * {
+ *   "items": [...],
+ *   "metadata": {
+ *     "anchor_set": null,
+ *     "anchor_set_error": true
+ *   }
+ * }
+ * ```
+ *
+ * @example 앵커 설정 건너뜀 (pinned 앵커 보호)
+ * ```json
+ * {
+ *   "items": [...],
+ *   "metadata": {
+ *     "anchor_set": null,
+ *     "anchor_set_skipped": true,
+ *     "anchor_set_skipped_reason": "pinned_anchor_protected"
+ *   }
+ * }
+ * ```
+ *
+ * @example 앵커 설정 비활성화
+ * ```json
+ * {
+ *   "items": [...],
+ *   "metadata": {
+ *     "anchor_set": null
+ *   }
+ * }
+ * ```
+ *
+ * @example 이웃 기억 미포함 (include_neighbors=false)
+ * ```json
+ * {
+ *   "items": [
+ *     {
+ *       "memory_id": "mem_12345",
+ *       "content": "검색 결과",
+ *       "neighbors": undefined  // neighbors 필드 없음
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export interface RecallResponse {
+    items: RecallResultItem[];
+    total_count: number;
+    query_time: number;
+    search_type: string;
+    metadata?: RecallResponseMetadata;
+    [key: string]: any;
+}
 export declare class RecallTool extends BaseTool {
     constructor();
     handle(params: any, context: ToolContext): Promise<ToolResult>;
+    /**
+     * trigger_conditions로 필터링
+     * match_trigger_conditions=true일 때, 현재 컨텍스트와 trigger_conditions가 매칭되는 항목만 반환
+     *
+     * PRD 요구사항: 구조화된 컨텍스트(예: tool_name, error_type, params)와 JSON 매칭
+     * 구조화된 컨텍스트가 제공되면 이를 우선 사용하고, 없으면 쿼리 텍스트를 사용
+     *
+     * @param items 검색 결과 항목 배열
+     * @param query 검색 쿼리 (컨텍스트로 사용, fallback)
+     * @param context 구조화된 컨텍스트 정보 (우선 사용)
+     * @returns 필터링된 항목 배열
+     */
+    private filterByTriggerConditions;
     /**
      * 검색 결과 후처리
      */
@@ -15,6 +183,28 @@ export declare class RecallTool extends BaseTool {
      * 적용된 필터 정보 반환
      */
     private getAppliedFilters;
+    /**
+     * 자동 앵커 설정 처리
+     * 가장 관련성 높은 기억(첫 번째 결과)을 슬롯 A에 앵커로 설정
+     *
+     * @param searchItems - 검색 결과 항목 배열
+     * @param agentId - 에이전트 ID
+     * @param context - 도구 컨텍스트
+     * @returns 앵커 설정 결과 (성공/실패/건너뜀 상태 포함)
+     */
+    private handleAutoSetAnchor;
+    /**
+     * 자동 이웃 기억 포함 처리
+     * 검색 결과의 상위 항목에 대해 이웃 기억을 자동으로 포함
+     *
+     * @param searchItems - 검색 결과 항목 배열
+     * @param neighborsLimit - 이웃 기억을 포함할 상위 결과의 개수
+     * @param neighborsPerItem - 각 검색 결과 항목당 조회할 이웃 기억의 최대 개수
+     * @param neighborsSimilarityThreshold - 이웃 기억 조회 시 유사도 임계값
+     * @param context - 도구 컨텍스트
+     * @returns 각 검색 결과 항목에 대한 이웃 기억 배열 (순서 보존)
+     */
+    private handleIncludeNeighbors;
     /**
      * 검색 쿼리 검증
      */

package/dist/domains/memory/tools/recall-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/recall-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAgEvE,qBAAa,UAAW,SAAQ,QAAQ;;IA8GhC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA8VpE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;;;;OASG;YACW,gCAAgC;CAuH/C"}
+{"version":3,"file":"recall-tool.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/tools/recall-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkBvE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAiED,qBAAa,UAAW,SAAQ,QAAQ;;IAiKhC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAsbpE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,yBAAyB;IA6EjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuF5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;;;;;OAQG;YACW,mBAAmB;IA4JjC;;;;;;;;;;OAUG;YACW,sBAAsB;IAmIpC;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;;;;OASG;YACW,gCAAgC;CAuH/C"}