memento-mcp-server 2.0.5 → 2.1.0

package/dist/server/routes/admin/evolution-demo/spec.d.ts

@@ -14,159 +14,37 @@ export declare const EvolutionDemoSnapshotSchema: z.ZodObject<{
         forgotten_count: z.ZodNumber;
         preserved_count: z.ZodNumber;
         summary_text: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        episodic_count: number;
-        semantic_count: number;
-        forgotten_count: number;
-        preserved_count: number;
-        summary_text: string;
-    }, {
-        episodic_count: number;
-        semantic_count: number;
-        forgotten_count: number;
-        preserved_count: number;
-        summary_text: string;
-    }>;
+    }, z.core.$strip>;
     explanation: z.ZodString;
     timestamp: z.ZodString;
     memory_groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         importance: z.ZodNumber;
         status: z.ZodString;
-        outcome: z.ZodEnum<["forget", "preserve", "pin"]>;
+        outcome: z.ZodEnum<{
+            forget: "forget";
+            preserve: "preserve";
+            pin: "pin";
+        }>;
         pinned: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        pinned: boolean;
-        importance: number;
-        status: string;
-        label: string;
-        outcome: "forget" | "preserve" | "pin";
-    }, {
-        pinned: boolean;
-        importance: number;
-        status: string;
-        label: string;
-        outcome: "forget" | "preserve" | "pin";
-    }>, "many">>;
+    }, z.core.$strip>>>;
     episodic_sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         summary: z.ZodString;
         created_at: z.ZodOptional<z.ZodString>;
         importance: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        summary: string;
-        importance?: number | undefined;
-        created_at?: string | undefined;
-    }, {
-        id: string;
-        summary: string;
-        importance?: number | undefined;
-        created_at?: string | undefined;
-    }>, "many">>;
+    }, z.core.$strip>>>;
     semantic_result: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
         summary: z.ZodString;
         source_count: z.ZodNumber;
         explanation: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        summary: string;
-        source_count: number;
-        explanation: string;
-    }, {
-        id: string;
-        summary: string;
-        source_count: number;
-        explanation: string;
-    }>>;
+    }, z.core.$strip>>;
     search_comparison: z.ZodOptional<z.ZodObject<{
         before_summary: z.ZodString;
         after_summary: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        before_summary: string;
-        after_summary: string;
-    }, {
-        before_summary: string;
-        after_summary: string;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    timestamp: string;
-    explanation: string;
-    scenario_id: string;
-    point_id: string;
-    point_label: string;
-    question: string;
-    answer: string;
-    memory_summary: {
-        episodic_count: number;
-        semantic_count: number;
-        forgotten_count: number;
-        preserved_count: number;
-        summary_text: string;
-    };
-    memory_groups?: {
-        pinned: boolean;
-        importance: number;
-        status: string;
-        label: string;
-        outcome: "forget" | "preserve" | "pin";
-    }[] | undefined;
-    episodic_sources?: {
-        id: string;
-        summary: string;
-        importance?: number | undefined;
-        created_at?: string | undefined;
-    }[] | undefined;
-    semantic_result?: {
-        id: string;
-        summary: string;
-        source_count: number;
-        explanation: string;
-    } | undefined;
-    search_comparison?: {
-        before_summary: string;
-        after_summary: string;
-    } | undefined;
-}, {
-    timestamp: string;
-    explanation: string;
-    scenario_id: string;
-    point_id: string;
-    point_label: string;
-    question: string;
-    answer: string;
-    memory_summary: {
-        episodic_count: number;
-        semantic_count: number;
-        forgotten_count: number;
-        preserved_count: number;
-        summary_text: string;
-    };
-    memory_groups?: {
-        pinned: boolean;
-        importance: number;
-        status: string;
-        label: string;
-        outcome: "forget" | "preserve" | "pin";
-    }[] | undefined;
-    episodic_sources?: {
-        id: string;
-        summary: string;
-        importance?: number | undefined;
-        created_at?: string | undefined;
-    }[] | undefined;
-    semantic_result?: {
-        id: string;
-        summary: string;
-        source_count: number;
-        explanation: string;
-    } | undefined;
-    search_comparison?: {
-        before_summary: string;
-        after_summary: string;
-    } | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const EvolutionDemoScenarioCatalogSchema: z.ZodObject<{
     scenarios: z.ZodArray<z.ZodObject<{
         scenario_id: z.ZodString;
@@ -174,45 +52,7 @@ export declare const EvolutionDemoScenarioCatalogSchema: z.ZodObject<{
         points: z.ZodArray<z.ZodObject<{
             point_id: z.ZodString;
             label: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            point_id: string;
-        }, {
-            label: string;
-            point_id: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        points: {
-            label: string;
-            point_id: string;
-        }[];
-        scenario_id: string;
-        title: string;
-    }, {
-        points: {
-            label: string;
-            point_id: string;
-        }[];
-        scenario_id: string;
-        title: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    scenarios: {
-        points: {
-            label: string;
-            point_id: string;
-        }[];
-        scenario_id: string;
-        title: string;
-    }[];
-}, {
-    scenarios: {
-        points: {
-            label: string;
-            point_id: string;
-        }[];
-        scenario_id: string;
-        title: string;
-    }[];
-}>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 //# sourceMappingURL=spec.d.ts.map

package/dist/server/routes/admin/evolution-demo/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/admin/evolution-demo/spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqCxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAatC,CAAC;AAaH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7C,CAAC"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../../src/server/routes/admin/evolution-demo/spec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqCxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAatC,CAAC;AAaH,eAAO,MAAM,kCAAkC;;;;;;;;;iBAE7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp-server",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "mcpName": "io.github.jee1/memento-mcp-server",
   "description": "AI Agent 기억 보조 MCP 서버 - 사람의 기억 구조를 모사한 스토리지+검색+요약+망각 메커니즘",
   "type": "module",
@@ -123,14 +123,18 @@
     "express": "^5.1.0",
     "express-rate-limit": "^8.5.2",
     "helmet": "^8.2.0",
-    "openai": "^4.20.1",
+    "openai": "^7.34.0",
     "sqlite-vec": "^0.1.9",
     "umap-js": "^1.3.3",
     "uuid": "^14.0.1",
     "ws": "^8.21.0",
-    "zod": "^3.22.4"
+    "zod": "^4.6.7"
+  },
+  "overrides": {
+    "zod": "$zod"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@playwright/test": "^1.61.1",
     "@types/better-sqlite3": "^7.6.13",
     "@types/cors": "^2.8.19",
@@ -138,12 +142,13 @@
     "@types/node": "^24.0.0",
     "@types/uuid": "^9.0.7",
     "@types/ws": "^8.18.1",
-    "@typescript-eslint/eslint-plugin": "^8.62.1",
-    "@typescript-eslint/parser": "^8.62.1",
+    "@typescript-eslint/eslint-plugin": "^8.71.2",
+    "@typescript-eslint/parser": "^8.71.2",
     "@vitest/coverage-v8": "^4.1.11",
-    "eslint": "^8.54.0",
-    "eslint-plugin-security": "^3.0.1",
+    "eslint": "^10.12.0",
+    "eslint-plugin-security": "^4.2.0",
     "eventsource": "^4.0.0",
+    "globals": "^17.13.0",
     "tsx": "^4.23.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11"

package/static/css/dashboard.css

@@ -492,6 +492,14 @@ body {
   stroke-opacity: 0.4;
 }
 
+.node.focus-dim {
+  opacity: 0.18;
+}
+
+.link.focus-dim {
+  stroke-opacity: 0.12;
+}
+
 /* 반응형 디자인 */
 @media (max-width: 48rem) {
   .dashboard-header {

package/static/dashboard.html

@@ -999,6 +999,7 @@
   <!-- Anchor Map 시각화 스크립트 -->
   <script src="/static/js/anchor-map-shared.js"></script>
   <script src="/static/js/anchor-map-layout.js"></script>
+  <script src="/static/js/neighbor-focus.js"></script>
   <script src="/static/js/anchor-map-render.js"></script>
   <script src="/static/js/anchor-map-search.js"></script>
   <script src="/static/js/anchor-map-data.js"></script>

package/static/graph.html

@@ -167,7 +167,8 @@
       flex-wrap: wrap;
     }
 
-    .type-check {
+    .type-check,
+    .relation-check {
       display: flex;
       align-items: center;
       gap: 3px;
@@ -175,7 +176,18 @@
       cursor: pointer;
     }
 
-    .type-check input { cursor: pointer; }
+    .type-check input,
+    .relation-check input { cursor: pointer; }
+
+    #local-depth-select,
+    #local-focus-hint {
+      font-size: var(--font-size-xs);
+      color: var(--color-graph-text-muted);
+    }
+
+    #local-focus-hint {
+      white-space: nowrap;
+    }
 
     .importance-row {
       display: flex;
@@ -476,6 +488,14 @@
       stroke-opacity: 0.12;
     }
 
+    .node.focus-dim {
+      opacity: 0.18;
+    }
+
+    .link.focus-dim {
+      stroke-opacity: 0.12;
+    }
+
     /* Dashboard embed — iframe viewport + Embedding Map 등과 동일한 라이트 패널 스타일 */
     .graph-view--embedded {
       height: 100%;
@@ -567,6 +587,15 @@
         <label class="type-check"><input type="checkbox" value="working" checked> Working</label>
       </div>
     </div>
+    <div class="filter-group graph-session-only">
+      <label>관계</label>
+      <div class="type-checks">
+        <label class="relation-check"><input type="checkbox" value="supports" checked> supports</label>
+        <label class="relation-check"><input type="checkbox" value="related_to" checked> related_to</label>
+        <label class="relation-check"><input type="checkbox" value="extracted_from" checked> extracted_from</label>
+        <label class="relation-check"><input type="checkbox" value="contradicts" checked> contradicts</label>
+      </div>
+    </div>
     <div class="filter-group graph-session-only">
       <label>중요도 ≥</label>
       <div class="importance-row">
@@ -603,6 +632,17 @@
       </label>
       <span id="orphan-hidden-badge" aria-live="polite"></span>
     </div>
+    <div class="filter-group graph-session-only">
+      <label for="local-mode-toggle">주변만 보기</label>
+      <input type="checkbox" id="local-mode-toggle">
+      <label for="local-depth-select">깊이</label>
+      <select id="local-depth-select">
+        <option value="1">1</option>
+        <option value="2" selected>2</option>
+        <option value="3">3</option>
+      </select>
+      <span id="local-focus-hint"></span>
+    </div>
     <button id="apply-btn" class="graph-session-only graph-action-button m-button m-button--primary">필터 적용</button>
     <button id="reset-btn" class="graph-session-only graph-action-button m-button m-button--secondary">초기화</button>
     <div class="header-spacer"></div>
@@ -665,6 +705,7 @@
   <script src="/static/js/graph-shared.js"></script>
   <script src="/static/js/graph-detail.js"></script>
   <script src="/static/js/graph-search.js"></script>
+  <script src="/static/js/neighbor-focus.js"></script>
   <script src="/static/js/graph-render.js"></script>
   <script src="/static/js/graph-fetch.js"></script>
   <script src="/static/js/graph.js"></script>

package/static/js/anchor-map-render.js

@@ -188,6 +188,24 @@
     return d3.drag().on('start', dragstarted).on('drag', dragged).on('end', dragended);
   }
 
+  function applyNeighborFocus(focusId) {
+    const api = global.__MEMENTO_NEIGHBOR_FOCUS__;
+    if (!api || !state.svg) return;
+    const keepIds = api.collectKeepIds(focusId, state.links);
+    state.svg.selectAll('.node').classed('focus-dim', function (d) {
+      return !keepIds.has(d.id);
+    });
+    state.svg.selectAll('.link').classed('focus-dim', function (d) {
+      return !api.edgeTouchesKeep(d, keepIds);
+    });
+  }
+
+  function clearNeighborFocus() {
+    if (!state.svg) return;
+    state.svg.selectAll('.node').classed('focus-dim', false);
+    state.svg.selectAll('.link').classed('focus-dim', false);
+  }
+
   function buildLinkSelection(g, links) {
     return g.append('g')
       .selectAll('line')
@@ -220,7 +238,9 @@
       .attr('stroke-dasharray', function (d) { return d.embedding_missing ? '5,3' : null; })
       .attr('opacity', function (d) { return d.embedding_missing ? 0.6 : 1.0; })
       .call(makeDragBehavior(simulation))
-      .on('click', function (event, d) { event.stopPropagation(); ns.selectNode(d); });
+      .on('click', function (event, d) { event.stopPropagation(); ns.selectNode(d); })
+      .on('mouseover', function (_event, d) { applyNeighborFocus(d.id); })
+      .on('mouseout', clearNeighborFocus);
   }
 
   function labelTextFor(d) {

package/static/js/graph-detail.js

@@ -43,8 +43,15 @@
   }
 
   ns.showDetail = function showDetail(d) {
+    if (d && d.id != null && d.id !== '') {
+      ns.state.localFocusId = d.id;
+    }
+    ns.updateLocalFocusHint(d);
     ns.dom.detailContent.innerHTML = buildDetailRows(d);
     ns.dom.detailPanel.style.display = 'block';
+    if (ns.state.localMode && ns.state.rawGraphNodes) {
+      ns.renderVisibleGraph();
+    }
   };
 
   ns.closePanel = function closePanel() {

package/static/js/graph-fetch.js

@@ -14,10 +14,16 @@
   ns.buildUrl = function buildUrl() {
     const { impSlider, fullGraphToggle } = ns.dom;
     const checked = [...document.querySelectorAll('.type-check input:checked')].map((el) => el.value);
+    const relationChecked = [...document.querySelectorAll('.relation-check input:checked')].map(
+      (el) => el.value
+    );
     const params = new URLSearchParams();
     if (checked.length < 4 && checked.length > 0) {
       params.set('types', checked.join(','));
     }
+    if (relationChecked.length < 4 && relationChecked.length > 0) {
+      params.set('relation_types', relationChecked.join(','));
+    }
     const imp = parseFloat(impSlider.value);
     if (imp > 0) {
       params.set('min_importance', imp.toFixed(2));
@@ -69,10 +75,19 @@
   function getVisibleGraph() {
     const nodes = state.rawGraphNodes ?? [];
     const edges = state.rawGraphEdges ?? [];
-    if (!ns.dom.orphanToggle.checked) {
-      return { nodes, edges, hiddenCount: 0 };
+    const visible = ns.dom.orphanToggle.checked
+      ? ns.filterConnectedNodes(nodes, edges)
+      : { nodes, edges, hiddenCount: 0 };
+    if (!state.localMode || !state.localFocusId) {
+      return visible;
     }
-    return ns.filterConnectedNodes(nodes, edges);
+    const trimmed = ns.trimToLocalDepth(
+      visible.nodes,
+      visible.edges,
+      state.localFocusId,
+      state.localDepth
+    );
+    return { nodes: trimmed.nodes, edges: trimmed.edges, hiddenCount: visible.hiddenCount };
   }
 
   function updateOrphanBadge(hiddenCount) {
@@ -83,6 +98,7 @@
   ns.renderVisibleGraph = function renderVisibleGraph() {
     const visible = getVisibleGraph();
     updateOrphanBadge(visible.hiddenCount);
+    ns.updateLocalFocusHint();
     state.lastGraphNodes = visible.nodes;
     state.lastGraphEdges = visible.edges;
 

package/static/js/graph-render.js

@@ -24,6 +24,24 @@
     return { svg, g };
   }
 
+  // One marker per SVG. userSpaceOnUse keeps the head a fixed size while stroke width follows confidence.
+  function appendArrowMarker(svg) {
+    svg
+      .append('defs')
+      .append('marker')
+      .attr('id', 'memory-graph-arrow')
+      .attr('viewBox', '0 -5 10 10')
+      .attr('refX', 10)
+      .attr('refY', 0)
+      .attr('markerWidth', 6)
+      .attr('markerHeight', 6)
+      .attr('orient', 'auto')
+      .attr('markerUnits', 'userSpaceOnUse')
+      .append('path')
+      .attr('d', 'M0,-5L10,0L0,5')
+      .attr('fill', 'context-stroke');
+  }
+
   function attachZoomAndClick(svg, g) {
     const { svgEl } = ns.dom;
     svg.call(
@@ -68,7 +86,8 @@
       .append('line')
       .attr('class', 'link')
       .attr('stroke', (d) => palette.edgeColors[d.relation_type] ?? palette.edgeColors.default)
-      .attr('stroke-width', (d) => Math.max(1, (d.confidence ?? 1) * 3));
+      .attr('stroke-width', (d) => Math.max(1, (d.confidence ?? 1) * 3))
+      .attr('marker-end', 'url(#memory-graph-arrow)');
     state.renderedLinkSelection = link;
     return link;
   }
@@ -96,12 +115,36 @@
       });
   }
 
+  function applyNeighborFocus(focusId) {
+    const api = global.__MEMENTO_NEIGHBOR_FOCUS__;
+    if (!api) {
+      return;
+    }
+    const keepIds = api.collectKeepIds(focusId, state.lastGraphEdges);
+    if (state.renderedNodeSelection) {
+      state.renderedNodeSelection.classed('focus-dim', (d) => !keepIds.has(d.id));
+    }
+    if (state.renderedLinkSelection) {
+      state.renderedLinkSelection.classed('focus-dim', (d) => !api.edgeTouchesKeep(d, keepIds));
+    }
+  }
+
+  function clearNeighborFocus() {
+    if (state.renderedNodeSelection) {
+      state.renderedNodeSelection.classed('focus-dim', false);
+    }
+    if (state.renderedLinkSelection) {
+      state.renderedLinkSelection.classed('focus-dim', false);
+    }
+  }
+
   function attachCircleHandlers(circle) {
     const { tooltip } = ns.dom;
     circle
       .on('mouseover', (_event, d) => {
         tooltip.style.display = 'block';
         tooltip.textContent = d.label;
+        applyNeighborFocus(d.id);
       })
       .on('mousemove', (event) => {
         tooltip.style.left = `${event.clientX + 12}px`;
@@ -109,6 +152,7 @@
       })
       .on('mouseout', () => {
         tooltip.style.display = 'none';
+        clearNeighborFocus();
       })
       .on('click', (event, d) => {
         event.stopPropagation();
@@ -149,13 +193,29 @@
     return { node, circle };
   }
 
+  // The marker tip is the line end. Stopping at the node center hides the arrow under the circle.
+  function arrowTargetPoint(source, target) {
+    const dx = target.x - source.x;
+    const dy = target.y - source.y;
+    const dist = Math.hypot(dx, dy);
+    const radius = target.__graphRadius ?? 8;
+    if (!dist || dist <= radius) {
+      return { x: target.x, y: target.y };
+    }
+    const scale = (dist - radius) / dist;
+    return {
+      x: source.x + dx * scale,
+      y: source.y + dy * scale,
+    };
+  }
+
   function bindSimulationTick(simulation, link, node) {
     simulation.on('tick', () => {
       link
         .attr('x1', (d) => d.source.x)
         .attr('y1', (d) => d.source.y)
-        .attr('x2', (d) => d.target.x)
-        .attr('y2', (d) => d.target.y);
+        .attr('x2', (d) => arrowTargetPoint(d.source, d.target).x)
+        .attr('y2', (d) => arrowTargetPoint(d.source, d.target).y);
       node.attr('transform', (d) => `translate(${d.x},${d.y})`);
     });
   }
@@ -164,6 +224,7 @@
     const { W, H } = getContainerSize();
     const palette = ns.getGraphPalette();
     const { svg, g } = createSvgRoot(W, H);
+    appendArrowMarker(svg);
     attachZoomAndClick(svg, g);
 
     const rScale = createRadiusScale();