claude-memory-layer 1.0.11 → 1.0.13

package/dist/ui/app.js

@@ -11,6 +11,7 @@ const state = {
   sharedStats: null,
   mostAccessed: null,
   helpfulness: null,
+  retrievalTraces: null,
   currentLevel: 'L0',
   currentSort: 'recent',
   currentView: 'overview',
@@ -235,17 +236,19 @@ async function refreshData() {
   if(btn) btn.classList.add('loading');
 
   try {
-    const [stats, shared, mostAccessed, helpfulness] = await Promise.all([
+    const [stats, shared, mostAccessed, helpfulness, retrievalTraces] = await Promise.all([
       fetch(apiUrl(`${API_BASE}/stats`)).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/shared`)).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/most-accessed`, { limit: 10 })).then(r => r.json()).catch(() => null),
-      fetch(apiUrl(`${API_BASE}/stats/helpfulness`, { limit: 5 })).then(r => r.json()).catch(() => null)
+      fetch(apiUrl(`${API_BASE}/stats/helpfulness`, { limit: 5 })).then(r => r.json()).catch(() => null),
+      fetch(apiUrl(`${API_BASE}/stats/retrieval-traces`, { limit: 20 })).then(r => r.json()).catch(() => null)
     ]);
 
     state.stats = stats;
     state.sharedStats = shared;
     state.mostAccessed = mostAccessed;
     state.helpfulness = helpfulness;
+    state.retrievalTraces = retrievalTraces;
 
     updateStatsUI();
     updateSharedUI();
@@ -397,6 +400,7 @@ function updateMemoryUsageUI() {
   updateGraduationBars();
   updateHelpfulnessUI();
   updateMostHelpfulList();
+  updateRetrievalTraceUI();
 }
 
 function updateGraduationBars() {
@@ -483,6 +487,69 @@ function updateMostHelpfulList() {
   }).join('');
 }
 
+
+function updateRetrievalTraceUI() {
+  const summaryEl = document.getElementById('retrieval-trace-summary');
+  const listEl = document.getElementById('retrieval-trace-list');
+  if (!summaryEl || !listEl) return;
+
+  const payload = state.retrievalTraces;
+  const stats = payload?.stats;
+  const traces = payload?.traces || [];
+
+  if (!stats || !Number.isFinite(stats.totalQueries) || stats.totalQueries === 0) {
+    summaryEl.innerHTML = '<span style="color:var(--text-muted);">No retrieval traces yet.</span>';
+    listEl.innerHTML = '<div style="padding:12px; text-align:center; color:var(--text-muted); font-size:13px;">No query/context trace data</div>';
+    return;
+  }
+
+  const selectionRate = ((stats.selectionRate || 0) * 100).toFixed(1);
+  summaryEl.innerHTML = `
+    <div style="display:flex; gap:14px; flex-wrap:wrap; font-size:12px;">
+      <span><strong>${formatNumber(stats.totalQueries)}</strong> queries</span>
+      <span><strong>${Number(stats.avgCandidateCount || 0).toFixed(1)}</strong> avg candidates</span>
+      <span><strong>${Number(stats.avgSelectedCount || 0).toFixed(1)}</strong> avg selected</span>
+      <span><strong>${selectionRate}%</strong> selection rate</span>
+    </div>
+  `;
+
+  listEl.innerHTML = traces.slice(0, 8).map((t) => {
+    const ts = t.createdAt ? new Date(t.createdAt).toLocaleString() : '-';
+    const confidence = t.confidence || 'n/a';
+    const selected = Number(t.selectedCount || 0);
+    const candidates = Number(t.candidateCount || 0);
+    const selectedDetails = (t.selectedDetails || []).slice(0, 2);
+    const candidateDetails = (t.candidateDetails || []).slice(0, 3);
+    const selectedIdsHtml = selectedDetails.length > 0
+      ? selectedDetails.map((d) => {
+          const breakdown = `score=${Number(d.score || 0).toFixed(3)} · s=${Number(d.semanticScore || 0).toFixed(3)} · l=${Number(d.lexicalScore || 0).toFixed(3)} · r=${Number(d.recencyScore || 0).toFixed(3)}`;
+          return `<span class="event-type-badge" style="cursor:pointer;" onclick="openDetailModal('${d.eventId}')" title="${escapeHtml(breakdown)}">${escapeHtml((d.eventId || '').slice(0, 8))}...</span>`;
+        }).join(' ')
+      : ((t.selectedEventIds || []).slice(0, 2).map((id) => `<span class="event-type-badge" style="cursor:pointer;" onclick="openDetailModal('${id}')">${escapeHtml((id || '').slice(0, 8))}...</span>`).join(' ') || '-');
+
+    const scoreBreakdownHtml = selectedDetails.length > 0
+      ? selectedDetails.map((d) => `<div style="font-size:10px; color:var(--text-muted);">${escapeHtml((d.eventId || '').slice(0, 8))}... → score ${Number(d.score || 0).toFixed(3)} (s ${Number(d.semanticScore || 0).toFixed(3)}, l ${Number(d.lexicalScore || 0).toFixed(3)}, r ${Number(d.recencyScore || 0).toFixed(3)})</div>`).join('')
+      : '';
+
+    return `
+      <div class="shared-item" style="align-items:flex-start;">
+        <div class="shared-info" style="align-items:flex-start; flex-direction:column; gap:4px;">
+          <span style="font-size:12px; color:var(--text-secondary);"><strong>Q:</strong> ${escapeHtml((t.queryText || '').slice(0, 120))}</span>
+          <span style="font-size:11px; color:var(--text-muted);">${ts} · strategy=${escapeHtml(t.strategy || 'auto')} · conf=${escapeHtml(confidence)}</span>
+          <span style="font-size:11px; color:var(--text-muted);">selected IDs: ${selectedIdsHtml}</span>
+          <span style="font-size:11px; color:var(--text-muted);">candidates: ${candidateDetails.map((d) => `<span class=\"event-type-badge\" style=\"cursor:pointer;\" onclick=\"openDetailModal('${d.eventId}')\">${escapeHtml((d.eventId || '').slice(0, 8))}...</span>`).join(' ') || '-'}</span>
+          ${scoreBreakdownHtml}
+        </div>
+        <div style="display:flex; flex-direction:column; align-items:flex-end; gap:2px; min-width:68px;">
+          <span style="font-size:13px; font-weight:600; color:var(--accent-primary);">${selected}/${candidates}</span>
+          <span style="font-size:10px; color:var(--text-muted);">sel/cand</span>
+        </div>
+      </div>
+    `;
+  }).join('');
+}
+
+
 // --- Charts ---
 
 async function initActivityChart() {

package/dist/ui/index.html

@@ -271,6 +271,14 @@
                   <div style="padding:12px; text-align:center; color:var(--text-muted); font-size:13px;">Loading...</div>
                 </div>
               </div>
+
+              <div style="margin-top:20px;">
+                <div class="section-label">Retrieval Trace (1:1)</div>
+                <div id="retrieval-trace-summary" style="padding:8px 0; font-size:13px; color:var(--text-muted);">Loading...</div>
+                <div id="retrieval-trace-list" class="shared-list">
+                  <div style="padding:12px; text-align:center; color:var(--text-muted); font-size:13px;">Loading...</div>
+                </div>
+              </div>
             </div>
 
           </div>

package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md

@@ -0,0 +1,271 @@
+# mcp-memory-service 코드 리뷰 기반 개선 제안서
+
+작성일: 2026-02-26  
+대상:
+- 참고 레포: `~/workspace/mcp-memory-service` (commit `8d7e582`)
+- 개선 대상: `~/workspace/claude-memory-layer`
+
+---
+
+## 0) 결론 요약
+
+`claude-memory-layer`는 이미 구조가 매우 좋고(프로젝트 해시 격리, scoped retrieval, outbox, endless mode, shared store 실험), **핵심 기능은 충분히 경쟁력 있음**.
+
+다만 `mcp-memory-service`를 기준으로 봤을 때 실제 운영 관점에서 보강하면 체감이 큰 포인트는 아래 5가지:
+
+1. **멀티-repo 스코프 강제 정책**(기본 격리 + 명시적 cross-repo)
+2. **태그 taxonomy 표준화**(`proj:`, `agent:`, `topic:`, `q:` 등) + 자동 주입
+3. **HTTP/SSE API 레이어**(운영/관측/통합성 증가)
+4. **하이브리드 검색(BM25+Vector) 공식화** 및 점수 퓨전 표준화
+5. **운영 안정성 레이어**(헬스체크, 백업/복구, 보존정책, 인증)
+
+즉, 지금은 “강한 코어 엔진” 단계고, 다음 단계는 “**운영형 메모리 플랫폼**”으로 가는 게 맞음.
+
+---
+
+## 1) 조사 방식
+
+### 확인한 핵심 파일(참고 레포)
+- `README.md`
+- `docs/architecture.md`
+- `docs/agents/README.md`
+- `docs/mastery/configuration-guide.md`
+- `src/mcp_memory_service/models/tag_taxonomy.py`
+- `src/mcp_memory_service/web/api/memories.py`
+- `src/mcp_memory_service/web/api/search.py`
+
+### 확인한 핵심 파일(현재 레포)
+- `README.md`
+- `package.json`
+- `src/services/memory-service.ts`
+- `src/core/retriever.ts`
+- `src/core/event-store.ts`
+- `docs/OPERATIONS.md`
+- `docs/MEMU_ADOPTION.md`
+
+---
+
+## 2) 현재 `claude-memory-layer` 강점 (유지해야 할 것)
+
+1. **프로젝트 격리 설계가 이미 있음**
+   - `hashProjectPath()` + `~/.claude-code/memory/projects/{hash}`
+   - 세션 레지스트리로 session→project 매핑
+
+2. **검색 전략 설계가 좋음**
+   - `fast/deep/auto`, fallback chain, scope filter, rerank, graph-hop
+   - 실전성 높은 토큰/정확도 트레이드오프
+
+3. **쓰기 파이프라인 안정성 의식이 강함**
+   - SQLite primary, outbox, background worker
+   - hook 경량 모드(lightweightMode)
+
+4. **고급 메모리 기능이 이미 구현/실험됨**
+   - graduation, endless mode, shared store, markdown mirror
+
+=> 요약: 엔진 레벨은 이미 상당히 앞서 있음.
+
+---
+
+## 3) `mcp-memory-service` 대비 갭 분석
+
+### A. 멀티-repo 운영 규칙의 “정책 강제력”
+
+- 현 상태: 프로젝트 해시 분리는 있으나, 교차 검색/주입 정책이 코드/문서에서 강하게 표준화되어 있지는 않음
+- 참고 레포 포인트:
+  - `agent:` 태그 자동 주입(`X-Agent-ID`)
+  - 태그 namespace 체계 명시(`proj:`, `topic:`, `q:` ...)
+
+**리스크**
+- 여러 repo를 운용할수록 검색 누수(다른 repo 기억 주입) 가능성 증가
+
+**개선안**
+- 기본 policy: `same-project-only`
+- cross-project는 explicit flag + 이유(required reason) 필요
+- retrieval 요청 시 project_id 부재면 hard-fail(옵션)
+
+---
+
+### B. 태그 체계 표준화 부족
+
+- 현 상태: metadata/scope가 강하지만 태그 네임스페이스 규약은 상대적으로 약함
+- 참고 레포 포인트:
+  - `TagTaxonomy`를 별도 모델로 정의하고 namespace 유효성 관리
+
+**개선안**
+- `src/core/tag-taxonomy.ts` 신설
+- 표준 namespace:
+  - `proj:` repository identifier
+  - `agent:` 실행 주체
+  - `topic:` 주제
+  - `q:` 품질/신뢰 등급
+  - `t:` 시간/스프린트
+  - `sys:` 시스템 자동 태그
+- ingest 시 최소 `proj:<hash>` 자동 부착
+
+---
+
+### C. HTTP/SSE 운용 계층 부재(또는 약함)
+
+- 현 상태: CLI/hooks 중심 구조가 강점이지만, 외부 오케스트레이터/다중 클라이언트 연동은 제한적
+- 참고 레포 포인트:
+  - REST API + SSE + dashboard 연동
+
+**개선안**
+- 최소 API부터 시작:
+  - `POST /api/memories`
+  - `POST /api/memories/search`
+  - `GET /api/memories?project=...`
+  - `GET /api/health`
+- SSE 이벤트:
+  - memory_stored
+  - memory_deleted
+  - search_completed
+
+---
+
+### D. Hybrid search 점수 체계 공식화 필요
+
+- 현 상태: fast/deep + rerank는 이미 훌륭함
+- 부족한 점: “BM25 + Vector + Recency + Quality”를 운영상 조정 가능한 공식으로 고정 문서화한 수준은 약함
+- 참고 레포 포인트:
+  - hybrid 검색을 제품 기능으로 명시
+
+**개선안**
+- `score = w_semantic*S + w_lexical*L + w_recency*R + w_quality*Q`
+- env/config에서 가중치 조정 가능하게
+- quality 점수 부재 시 graceful fallback
+
+---
+
+### E. 운영/보안 레이어
+
+- 현 상태: runbook/ops 스크립트 존재(좋음)
+- 참고 레포 포인트:
+  - 인증, 헬스/환경 점검, 상세 config 가이드
+
+**개선안**
+- 최소 추가:
+  - `MEMORY_API_KEY` 인증(HTTP 도입 시)
+  - `/api/health` + 저장소 상태 + outbox backlog 노출
+  - 백업/복구 명령 표준화
+  - 보존정책(TTL, 중요도 기반 정리) 명문화
+
+---
+
+## 4) 우선순위 로드맵 (실행 순서)
+
+## P0 (당장 효과 큼, 1~3일)
+1. 멀티-repo 스코프 기본 정책 강제
+2. `proj:` 자동 태깅
+3. 검색 기본값 same-project-only
+4. 교차 검색은 명시적 옵션 필요
+
+## P1 (1~2주)
+1. tag taxonomy 모듈화
+2. hybrid scoring 공식화 + 설정화
+3. health endpoint/metrics 정리
+
+## P2 (2~4주)
+1. HTTP API + SSE 추가
+2. 인증(OAuth까지는 아니어도 API key)
+3. 팀/멀티클라이언트 운영 문서화
+
+---
+
+## 5) 구체 구현 제안 (코드 레벨)
+
+### 5.1 Retrieval 옵션 확장
+`src/core/retriever.ts`에 아래 정책 필드 추가 권장:
+
+- `projectScopeMode: 'strict' | 'prefer' | 'global'`
+- `allowedProjectHashes?: string[]`
+- `crossProjectReason?: string`
+
+`strict`일 때 현재 프로젝트 hash 불일치 결과는 필터링.
+
+---
+
+### 5.2 자동 태깅 훅
+`MemoryService.storeUserPrompt/storeAgentResponse/storeToolObservation`에서 metadata 병합 시:
+
+- `scope.project.hash`
+- `scope.project.path`
+- `tags` 개념을 도입하면 `proj:${projectHash}` 자동 주입
+
+---
+
+### 5.3 정책 파일 도입
+`claude-memory-layer/policies/memory-scope-policy.json` 예:
+
+```json
+{
+  "defaultMode": "strict",
+  "allowCrossProject": false,
+  "requireReasonForCrossProject": true,
+  "alwaysIncludeTags": ["sys:auto", "proj:auto"]
+}
+```
+
+---
+
+### 5.4 운영 API 최소셋
+향후 `src/server`에 라우트 추가:
+
+- `GET /api/health`
+  - db 연결 상태
+  - vector worker backlog
+  - failed outbox 개수
+- `POST /api/memories/search`
+  - projectHash 필수(운영 모드에서)
+
+---
+
+## 6) 여러 repository 관리 관점 평가
+
+질문의 핵심(“여러 repo 관리 용이?”)에 대해:
+
+- `claude-memory-layer` 현재 구조는 **잠재적으로 매우 유리**
+  - 프로젝트 해시 분리 구조가 이미 있기 때문
+- 하지만 운영 안정성은 “격리 정책 강제 + 표준 태깅 + API 관측”이 있어야 완성
+
+즉, **아키텍처 방향은 맞고, 운영 레이어 보강이 필요**.
+
+---
+
+## 7) 추천 최종 전략
+
+`/Users/namsangboy/workspace/claude-memory-layer`를 계속 중심으로 가져가되:
+
+1. P0/P1 개선 먼저 적용해서 “멀티-repo 안 섞이는 안정성” 확보
+2. 그 다음 HTTP/SSE/API key 붙여서 외부 자동화/다중 클라이언트 지원
+3. 마지막에 공유 지식(shared store) 룰을 엄격히(검증된 것만 승격)
+
+이 순서가 리스크/효율 밸런스가 가장 좋음.
+
+---
+
+## 8) 보너스: 바로 체크할 TODO
+
+- [x] `projectScopeMode` 옵션 추가
+- [x] 기본 검색 strict project filter 적용
+- [x] `proj:<hash>` 자동 태깅
+- [x] tag taxonomy 모듈 생성
+- [x] health API에 outbox failed/pending 수치 노출 (`GET /api/health`)
+- [ ] 문서에 cross-project 허용 조건 명시
+
+### P1 적용 메모 (이번 반영)
+
+- 태그 taxonomy 파일 추가: `src/core/tag-taxonomy.ts`
+  - namespace 유효성 검증(`sys:, q:, proj:, topic:, t:, user:, agent:`)
+  - tags 정규화(`normalizeTags`)로 ingest 시 품질 보정
+- rerank 가중치 설정화
+  - 환경변수 지원:
+    - `MEMORY_RERANK_WEIGHT_SEMANTIC`
+    - `MEMORY_RERANK_WEIGHT_LEXICAL`
+    - `MEMORY_RERANK_WEIGHT_RECENCY`
+  - 3개가 모두 유효하면 정규화해서 고정값 사용
+  - 없으면 기존 adaptive/기본 동작 fallback
+
+---
+
+원하면 다음 단계로 health endpoint/운영 지표(outbox backlog, failed 카운트)까지 이어서 붙일 수 있음.

package/docs/MEMU_ADOPTION.md

@@ -0,0 +1,40 @@
+# memU Adoption Notes (claude-memory-layer)
+
+이 프로젝트에 적용된 memU 장점 요약입니다.
+
+## 1) Dual Retrieval Strategy
+- `strategy: "fast" | "deep" | "auto"`
+- `fast`: 키워드 기반(FTS/keyword) 우선 탐색으로 저지연 검색
+- `deep`: 임베딩 + 벡터 검색 + 재정렬(키워드 오버랩 가중)로 정밀 검색
+
+## 2) Scoped Retrieval Filters
+`scope`로 검색 범위를 좁혀 정확도를 높입니다.
+
+- `sessionId` / `sessionIdPrefix`
+- `eventTypes`
+- `canonicalKeyPrefix`
+- `contentIncludes` (부분 문자열 OR)
+- `metadata` (dot-path, 예: `scope.project.id`)
+
+## 3) Hybrid Rerank Behavior
+`rerankWithKeyword=true`일 때 semantic score에 키워드 오버랩/최근성 점수를 가중해 재정렬합니다.
+
+## 4) Test Coverage
+- `tests/retriever.memu-adoption.test.ts`
+  - metadata dot-path 스코프 필터
+  - fast 전략 키워드 경로
+- `tests/retriever-strategy-scope.test.ts`
+  - fast/deep 전략 및 복합 스코프 필터
+
+## Quick Example
+```ts
+await retriever.retrieve('브리핑', {
+  strategy: 'deep',
+  topK: 10,
+  scope: {
+    sessionIdPrefix: 'agent:main:',
+    canonicalKeyPrefix: 'pref/briefing',
+    metadata: { 'scope.project.id': 'alpha' }
+  }
+});
+```

package/memory/.claude-plugin/commands/2026-02-25.md

@@ -0,0 +1,263 @@
+
+## 2026-02-25T12:31:21.733Z | a551b032-ffdd-43e5-8f34-c42b12b091ce
+- type: session_summary
+- session: import:organized
+# /memory-forget
+
+Remove specific memories from storage.
+
+## Usage
+
+```
+/memory-forget <event-id>
+/memory-forget --session <session-id>
+/memory-forget --before <date>
+```
+
+## Arguments
+
+- `event-id`: Specific event ID to forget
+- `--session <id>`: Forget all events from a session
+- `--before <date>`: Forget events before a date (YYYY-MM-DD)
+- `--confirm`: Skip confirmation prompt
+
+## Examples
+
+```
+/memory-forget abc123-def456
+/memory-forget --session session_xyz --confirm
+/memory-forget --before 2024-01-01
+```
+
+## Description
+
+Removes memories from storage. This operation:
+
+1. Marks events as deleted in EventStore (soft delete)
+2. Removes corresponding vectors from LanceDB
+3. Updates memory level statistics
+
+⚠️ **Note**: Due to the append-only architecture, deleted events are marked but not physically removed from the event log. Vector embeddings are physically deleted.
+
+## Implementation
+
+```bash
+node dist/cli/index.js forget $ARGUMENTS
+```
+
+## 2026-02-25T12:31:21.738Z | ec065482-7832-4ec6-9fbf-584ca1d05d75
+- type: session_summary
+- session: import:organized
+# /memory-history
+
+View conversation history from memory.
+
+## Usage
+
+```
+/memory-history [options]
+```
+
+## Options
+
+- `--session <id>`: Show history for a specific session
+- `--limit <n>`: Limit number of events (default: 20)
+- `--type <type>`: Filter by event type (user_prompt, agent_response, session_summary)
+
+## Examples
+
+```
+/memory-history
+/memory-history --limit 50
+/memory-history --session abc123
+/memory-history --type user_prompt
+```
+
+## Description
+
+Displays stored conversation events from memory. By default shows the most recent events across all sessions. Use filters to narrow down to specific sessions or event types.
+
+## Implementation
+
+```bash
+node dist/cli/index.js history $ARGUMENTS
+```
+
+## 2026-02-25T12:31:21.740Z | 5be40880-b0f7-4aa3-9844-7190b1fa06cf
+- type: session_summary
+- session: import:organized
+# /memory-import
+
+Import existing Claude Code conversation history into memory.
+
+## Usage
+
+```
+/memory-import [options]
+```
+
+## Options
+
+- `--project <path>`: Import from specific project path
+- `--session <file>`: Import a specific session file (JSONL)
+- `--all`: Import all sessions from all projects
+- `--limit <n>`: Limit messages per session
+- `--verbose`: Show detailed progress
+
+## Examples
+
+```
+/memory-import
+/memory-import --project /home/user/myproject
+/memory-import --all
+/memory-import --session ~/.claude/projects/xyz/abc123.jsonl
+/memory-import --all --limit 100 --verbose
+```
+
+## Description
+
+This command imports existing Claude Code conversation history from JSONL session files into the memory store. This allows the plugin to learn from your previous conversations and provide more relevant context in future sessions.
+
+### What gets imported:
+
+- **User prompts**: Your questions and requests
+- **Agent responses**: Claude's responses (truncated to 5000 chars)
+- **Session metadata**: Timestamps and session IDs
+
+### Deduplication
+
+The importer automatically skips duplicate messages based on content hash, so you can safely run import multiple times without creating duplicate memories.
+
+### Session Files Location
+
+Claude Code stores session history in:
+```
+~/.claude/projects/<project-hash>/<session-id>.jsonl
+```
+
+Use `/memory-list` to see available sessions before importing.
+
+## Implementation
+
+```bash
+node dist/cli/index.js import $ARGUMENTS
+```
+
+## 2026-02-25T12:31:21.743Z | 3d6ec7cb-b61d-4638-b767-a2d6a1e1b7bd
+- type: session_summary
+- session: import:organized
+# /memory-list
+
+List available Claude Code sessions that can be imported.
+
+## Usage
+
+```
+/memory-list [options]
+```
+
+## Options
+
+- `--project <path>`: Filter sessions by project path
+
+## Examples
+
+```
+/memory-list
+/memory-list --project /home/user/myproject
+```
+
+## Description
+
+Shows all available Claude Code session files that can be imported into memory. Each session displays:
+
+- **Session ID**: Unique identifier for the session
+- **Modified date**: When the session was last updated
+- **File size**: Size of the session file
+- **Path**: Full path to the JSONL file
+
+Use this command to identify which sessions you want to import before running `/memory-import`.
+
+## Implementation
+
+```bash
+node dist/cli/index.js list $ARGUMENTS
+```
+
+## 2026-02-25T12:31:21.745Z | fd04fc38-ab42-4406-aadc-9d73fdbbb079
+- type: session_summary
+- session: import:organized
+# /memory-search
+
+Search through stored memories using semantic search.
+
+## Usage
+
+```
+/memory-search <query>
+```
+
+## Arguments
+
+- `query`: The search query to find relevant memories
+
+## Examples
+
+```
+/memory-search how to implement authentication
+/memory-search React component patterns
+/memory-search database optimization
+```
+
+## Description
+
+This command searches through all stored conversation memories using semantic similarity. It returns the most relevant memories that match your query, along with their confidence scores.
+
+The search uses AXIOMMIND weighted scoring:
+- **High confidence** (≥0.92): Strong match, likely relevant
+- **Suggested** (≥0.75): May be relevant, review recommended
+- **None** (<0.75): No significant matches found
+
+## Implementation
+
+```bash
+node dist/cli/index.js search "$ARGUMENTS"
+```
+
+## 2026-02-25T12:31:21.746Z | dc8f7b26-d8dd-461f-9911-54b26b23343e
+- type: session_summary
+- session: import:organized
+# /memory-stats
+
+View memory storage statistics.
+
+## Usage
+
+```
+/memory-stats
+```
+
+## Description
+
+Displays statistics about stored memories including:
+
+- Total number of events
+- Number of vector embeddings
+- Memory level distribution (L0-L4)
+- Storage size information
+
+## Memory Levels
+
+The graduation pipeline moves memories through these levels:
+
+- **L0**: Raw events (EventStore)
+- **L1**: Structured JSON (patterns, summaries)
+- **L2**: Type candidates (validated schemas)
+- **L3**: Verified knowledge (cross-session validated)
+- **L4**: Active/searchable (indexed, readily available)
+
+## Implementation
+
+```bash
+node dist/cli/index.js stats
+```