claude-memory-layer 1.0.23 → 1.0.25

package/specs/memory-utilization-improvements/spec.md

@@ -0,0 +1,308 @@
+# Spec: Memory Utilization Improvements
+
+## 목표
+
+f4d5c120 프로젝트 분석을 통해 확인된 메모리 시스템의 cascade failure를 해소하고,
+저장된 메모리가 실제로 Claude 응답에 기여하는 비율을 높인다.
+
+**성공 기준**:
+- Retrieval trace 기록률 > 95% (현재 ~0%)
+- 메모리 Graduation L1+ 비율 > 10% (현재 0%)
+- Tool Observation 중 저장 비율 < 30% (현재 100%)
+- 세션 요약 생성률 > 80% (현재 5%)
+
+---
+
+## 개선 항목 (우선순위 순)
+
+---
+
+### IMP-01: Retrieval Trace 동기 기록
+
+**우선순위**: P0 (Blocker)
+
+**문제**:
+- `adherence: true` 이벤트가 존재 → 검색은 실행됨
+- 하지만 retrieval_traces 테이블에 단 1건만 기록
+- 비동기 trace INSERT가 hook 프로세스 종료 전에 완료되지 않는 것으로 추정
+
+**원인 분석**:
+```typescript
+// user-prompt-submit.ts 추정 흐름
+async function hook() {
+  const memories = await retrieveMemories(query);   // 검색 실행
+  await writeToStdout(memories);                    // 결과 출력 (hook 종료)
+  await recordTrace(memories);                      // ← 여기서 프로세스가 이미 종료됨
+}
+```
+
+**해결 방안**:
+1. `recordTrace()`를 `retrieveMemories()` 직후, stdout 출력 전에 동기적으로 실행
+2. better-sqlite3의 동기 API 사용 (이미 사용 중) → trace INSERT를 sync로 변경
+3. trace 기록 실패 시 stderr에 경고 출력
+
+**변경 파일**:
+- `src/hooks/user-prompt-submit.ts` — trace 기록 위치를 stdout 출력 전으로 이동
+- `src/core/sqlite-event-store.ts` — `recordRetrievalTrace()`를 동기 메서드로 변경
+
+**검증**:
+```sql
+-- 개선 후: 세션당 retrieval_traces 수 확인
+SELECT session_id, COUNT(*) as trace_count
+FROM retrieval_traces
+GROUP BY session_id
+ORDER BY trace_count DESC;
+```
+
+---
+
+### IMP-02: Tool Observation 선택적 저장
+
+**우선순위**: P0
+
+**문제**:
+- 저장 이벤트의 93%가 tool observation
+- 대부분 다음 세션에서 재사용 가치가 없는 ephemeral 데이터
+- FTS5 검색 코퍼스 비대화 → 검색 노이즈 증가
+
+**저장 가치 기준**:
+
+| Tool | 저장 조건 | 이유 |
+|------|---------|------|
+| Bash | 오류(exit_code≠0), 또는 중요 출력 키워드 포함 | 성공적인 단순 명령은 가치 낮음 |
+| Write | 항상 저장 | 파일 생성/수정은 중요 컨텍스트 |
+| Edit | 항상 저장 | 코드 변경은 추적 필요 |
+| Read | 저장 안 함 (기본값) | 파일 내용은 재현 가능 |
+| Glob | 저장 안 함 | 디렉토리 구조는 변하지 않음 |
+| Grep | 결과 10줄 초과 시만 저장 | 대용량 검색 결과만 의미있음 |
+| TodoRead/Write | 저장 안 함 | 이미 제외됨 |
+
+**중요 출력 키워드** (Bash 저장 트리거):
+```
+error, Error, ERROR, failed, Failed, FAILED,
+warning, Warning, exception, Exception,
+test passed, test failed, coverage,
+successfully deployed, build complete
+```
+
+**변경 파일**:
+- `src/hooks/post-tool-use.ts` — 툴별 저장 조건 필터링 로직 추가
+- `src/core/metadata-extractor.ts` — 중요도 점수 계산 함수 추가
+
+**예상 효과**:
+- 저장 이벤트 수 60~70% 감소
+- 검색 정밀도 향상
+- DB/벡터 스토어 용량 절감
+
+---
+
+### IMP-03: 세션 요약 신뢰성 개선
+
+**우선순위**: P1
+
+**문제**:
+- 40 세션 중 2건만 요약 (5%)
+- Stop hook은 프로세스 강제 종료 시 실행되지 않음
+- Session-start의 백필 로직이 요약을 생성하지 않고 있음
+
+**해결 방안**:
+
+**A. Session-start 백필에서 요약 생성 추가**:
+```typescript
+// session-start.ts
+async function backfillPreviousSession(prevSessionId: string) {
+  const events = await getSessionEvents(prevSessionId);
+  if (events.length > 3 && !hasSummary(prevSessionId)) {
+    const summary = await generateSummary(events);
+    await storeSummaryEvent(prevSessionId, summary);
+  }
+}
+```
+
+**B. LLM 없이 규칙 기반 요약 생성** (빠른 실행):
+```
+요약 템플릿:
+"[날짜] [N]턴 세션. 주요 작업: [user_prompt 첫 문장들].
+사용 툴: [tool 목록]. [오류 있으면: 발생한 오류: ...]"
+```
+
+**C. 주기적 요약 트리거** (선택적):
+- 세션 시작 시 이전 7일간 미요약 세션 최대 3개 백필
+
+**변경 파일**:
+- `src/hooks/session-start.ts` — 백필 시 요약 생성 호출 추가
+- `src/core/event-store.ts` — `generateRuleBasedSummary()` 함수 추가
+
+---
+
+### IMP-04: Graduation 수동 트리거 커맨드
+
+**우선순위**: P1
+
+**문제**:
+- 1,587건 전부 L0에 고착
+- IMP-01로 trace 기록이 정상화되어도 과거 데이터는 L0 유지
+- access_count가 0이면 L1 승격 불가
+
+**해결 방안**:
+
+**A. 히스토리 기반 access_count 역산**:
+```sql
+-- 동일 session의 이벤트가 이후 세션에서 재등장한 경우 access로 카운트
+-- user_prompt 이벤트 중 내용이 유사한 것들을 같은 토픽으로 그룹화
+```
+
+**B. CLI 커맨드 추가**:
+```bash
+claude-memory graduation --repair --project f4d5c120
+# 출력: Analyzed 1587 events, promoted 42 to L1, 8 to L2
+```
+
+**C. 시간 기반 자동 L1 승격** (규칙):
+- 생성 후 7일 이상 지난 user_prompt 이벤트
+- content 길이 > 100자
+- 동일 세션에서 3번 이상 유사 쿼리 존재
+
+**변경 파일**:
+- `src/core/graduation.ts` — 시간 기반 승격 규칙 추가
+- `src/cli/index.ts` — `graduation --repair` 서브커맨드 추가
+
+---
+
+### IMP-05: Embedding 모델 상태 모니터링
+
+**우선순위**: P1
+
+**문제**:
+- "Unknown model class 'eurobert'" 오류 반복
+- "RotaryEmbedding node execution errors" 반복
+- 사용자에게 오류가 노출되지만 자동 대처 없음
+
+**해결 방안**:
+
+**A. 모델 헬스체크 강화**:
+```typescript
+// semantic-daemon.ts
+async function checkModelHealth(): Promise<boolean> {
+  try {
+    await embed("test query");
+    return true;
+  } catch (e) {
+    logger.warn('Primary model failed, switching to fallback');
+    await switchToFallbackModel();
+    return false;
+  }
+}
+```
+
+**B. 대시보드에 모델 상태 표시**:
+- 현재 사용 중인 모델명
+- 최근 임베딩 성공률
+- 오류 로그 최근 5건
+
+**C. 임베딩 오류 시 키워드 전용 모드 자동 전환**:
+- `CLAUDE_MEMORY_RETRIEVAL_MODE=keyword` 임시 설정
+- 사용자에게 `<system>` 메시지로 알림
+
+**변경 파일**:
+- `src/hooks/semantic-daemon.ts` — 헬스체크 및 자동 폴백 강화
+- `src/server/api/stats.ts` — 모델 상태 지표 추가
+
+---
+
+### IMP-06: Helpfulness 피드백 루프
+
+**우선순위**: P2
+
+**문제**:
+- `sessions_helpfulness` 테이블 존재하나 데이터 없음
+- 검색된 메모리가 실제로 유용했는지 측정 불가
+- 유용하지 않은 메모리가 계속 상위에 노출될 수 있음
+
+**해결 방안**:
+
+**A. 휴리스틱 기반 자동 helpfulness 평가**:
+```
+Stop hook에서:
+1. 이번 세션에서 검색된 eventId 목록 로드
+2. agent_response에서 검색된 메모리의 canonicalKey가 언급되었는지 확인
+3. 언급된 경우 helpfulness = 0.8, 아닌 경우 0.2로 기록
+```
+
+**B. Retrieval Score 가중치에 helpfulness 반영**:
+```typescript
+// matcher.ts
+score = 0.35 × semanticScore +
+        0.25 × ftsScore +
+        0.20 × recencyBonus +
+        0.10 × statusMultiplier +
+        0.10 × helpfulnessScore;  // ← 신규 추가
+```
+
+**C. 낮은 helpfulness 이벤트 강등**:
+- 3회 이상 검색 후 helpfulness 평균 < 0.3이면 min_score 요건 상향
+
+**변경 파일**:
+- `src/hooks/stop.ts` — 자동 helpfulness 평가 로직 추가
+- `src/core/matcher.ts` — helpfulness 가중치 추가
+- `src/core/graduation.ts` — helpfulness 기반 강등 규칙 추가
+
+---
+
+### IMP-07: 검색 결과 컨텍스트 포맷 개선
+
+**우선순위**: P2
+
+**문제**:
+- 검색된 메모리가 Claude에게 전달될 때의 포맷 불명확
+- 메모리 출처(세션 날짜, 프로젝트)가 표시되지 않을 수 있음
+- 100% 선택률 → 품질 필터링 없이 모두 주입
+
+**해결 방안**:
+
+**A. 메모리 컨텍스트 포맷 구조화**:
+```
+<memory source="2026-02-25" session="5ef326be" confidence="0.87">
+  [쇼핑 어시스턴트 LLM function call 구현 중]
+  이전에 generalize_with_llm() 함수를 사용해서 상품 추천 로직을 개선했음.
+  결과: 응답 속도 40% 향상.
+</memory>
+```
+
+**B. 신뢰도 기준 필터링 강화**:
+- `high` confidence만 자동 주입 (현재 ≥0.92)
+- `suggested` confidence는 optional hint로 분리
+- 100% 선택률 → 선택적 포함으로 변경
+
+**변경 파일**:
+- `src/hooks/user-prompt-submit.ts` — 컨텍스트 포맷 템플릿 개선
+- `src/core/retriever.ts` — suggested confidence 분리 출력
+
+---
+
+## 구현 순서
+
+```
+Week 1 (Critical Path):
+  IMP-01: Trace 동기 기록 → 즉시 측정 가능
+  IMP-02: Tool Observation 필터링 → 노이즈 감소
+
+Week 2 (Quality):
+  IMP-03: 세션 요약 신뢰성
+  IMP-04: Graduation repair CLI
+  IMP-05: Embedding 모델 모니터링
+
+Week 3 (Feedback Loop):
+  IMP-06: Helpfulness 피드백
+  IMP-07: 컨텍스트 포맷 개선
+```
+
+---
+
+## 리스크
+
+| 리스크 | 가능성 | 영향 | 대응 |
+|--------|--------|------|------|
+| IMP-02로 중요 tool observation 누락 | 중 | 중 | 키워드 필터 화이트리스트 설정 |
+| IMP-04 graduation repair로 L0 과잉 승격 | 저 | 중 | dry-run 모드 먼저 실행 |
+| IMP-01 sync 변환으로 hook 응답 지연 | 저 | 저 | trace INSERT는 < 1ms (SQLite sync) |

package/specs/optional-duckdb/context.md

@@ -0,0 +1,77 @@
+# Context: DuckDB 설치 실패 문제
+
+## 에러 요약
+
+`npm install -g claude-memory-layer` 실행 시 특정 환경에서 설치 실패:
+
+```
+npm error code 1
+npm error path .../node_modules/duckdb
+npm error command failed: node-pre-gyp install --fallback-to-build
+npm error node-pre-gyp ERR! install response status 404 Not Found
+  on https://npm.duckdb.org/duckdb/duckdb-v0.10.2-node-v137-darwin-arm64.tar.gz
+npm error gyp ERR! build error (C++ template compile errors)
+```
+
+## 실패 환경
+
+- **OS**: macOS Darwin 25.2.0 (arm64)
+- **Node.js**: v24.13.1 (ABI v137)
+- **duckdb 버전**: 0.10.2 (`^0.10.0`)
+
+## 근본 원인
+
+### 1. Pre-built binary 없음
+`duckdb@0.10.2`는 Node.js v24 (ABI v137)용 pre-built binary를 제공하지 않는다.
+Node.js v24는 2024년 후반에 release된 최신 버전이고, duckdb@0.10.x 시리즈는 이를 지원하지 않는다.
+
+### 2. Source 컴파일 실패
+fallback으로 source 컴파일을 시도하지만, macOS 최신 Clang 컴파일러가
+duckdb@0.10.x의 C++ template syntax를 거부:
+
+```cpp
+// 에러 발생 패턴
+STATE::template ReadValue(...)   // Clang: "template argument list expected"
+OP::template Assign(state, input)
+```
+
+이 C++ 코드는 오래된 컴파일러 표준에서는 동작했지만, 최신 Clang (macOS 26 beta 포함)에서 엄격히 거부됨.
+
+## DuckDB의 역할
+
+코드베이스에서 DuckDB는 **분석 전용** 기능에만 사용:
+- `SyncWorker`: SQLite → DuckDB 데이터 동기화 (30초 간격)
+- `DuckDBAnalyticsStore`: 대시보드 통계 쿼리 (집계, 시계열)
+- 핵심 기능(이벤트 저장, 임베딩, 검색)은 모두 SQLite + LanceDB 사용
+
+## 현재 코드 상태
+
+이미 일부 graceful degradation 코드가 존재:
+```typescript
+// memory-service.ts
+if (this.analyticsStore) {
+  await this.analyticsStore.initialize();
+} catch (error) {
+  console.warn('Analytics store (DuckDB) initialization failed, using SQLite for reads');
+  // Continue without analytics
+}
+```
+
+그러나 **설치 단계**에서 실패하므로 runtime graceful degradation이 무의미.
+
+## 영향 범위
+
+- Node.js v20, v22: 정상 설치 (pre-built binary 존재)
+- Node.js v24+: 설치 실패 (pre-built binary 없음 + 컴파일 실패)
+- 향후 Node.js v25+: 동일 문제 발생 예상
+
+## 관련 파일
+
+| 파일 | 역할 |
+|------|------|
+| `package.json` | `"duckdb": "^0.10.0"` — required dependency |
+| `src/core/db-wrapper.ts` | `import duckdb from 'duckdb'` — top-level import |
+| `src/core/sync-worker.ts` | DuckDB SyncWorker 구현 |
+| `src/core/edge-repo.ts` | DuckDB analytics queries |
+| `src/services/memory-service.ts` | analyticsStore 초기화 및 사용 |
+| `src/server/api/utils.ts` | 대시보드 API에서 DuckDB 사용 |

package/specs/optional-duckdb/plan.md

@@ -0,0 +1,142 @@
+# Plan: DuckDB 완전 제거
+
+## 전략
+
+`duckdb`를 완전히 제거하고 `better-sqlite3`으로 모든 기능을 통합한다.
+`better-sqlite3`은 이미 primary dependency이므로 새 패키지 추가 없음.
+
+---
+
+## 변경 파일 목록
+
+| 파일 | 변경 |
+|------|------|
+| `package.json` | `duckdb` 제거 |
+| `src/core/db-wrapper.ts` | DuckDB API → better-sqlite3 API로 교체 |
+| `src/core/edge-repo.ts` | `Database` 타입 변경 (duckdb → better-sqlite3) |
+| `src/services/memory-service.ts` | analyticsStore / DuckDBAnalyticsStore 관련 코드 제거, SyncWorker 제거 |
+| `src/core/sync-worker.ts` | 파일 삭제 (또는 empty stub) |
+| `src/core/sqlite-event-store.ts` | edges 테이블 CREATE TABLE 추가 (없으면) |
+| `src/server/api/*.ts` | DuckDB analytics 쿼리 → SQLite 직접 쿼리로 교체 |
+
+---
+
+## Step 1: `src/core/db-wrapper.ts` 교체
+
+DuckDB callback API를 better-sqlite3 동기 API로 교체.
+better-sqlite3은 동기 API이므로 Promise wrapping이 간단해짐.
+
+```typescript
+// 변경 전: import duckdb from 'duckdb';
+// 변경 후:
+import Database from 'better-sqlite3';
+export type { Database };
+
+export async function dbRun(db: Database, sql: string, params: unknown[] = []): Promise<void> {
+  db.prepare(sql).run(...params);
+}
+
+export async function dbAll<T>(db: Database, sql: string, params: unknown[] = []): Promise<T[]> {
+  return db.prepare(sql).all(...(params as never[])) as T[];
+}
+```
+
+`toDate()`, `convertBigInts()` 등 유틸은 그대로 유지.
+
+---
+
+## Step 2: Edges 테이블을 SQLite에 추가
+
+`src/core/sqlite-event-store.ts`의 `initialize()` 에서 edges 테이블 생성:
+
+```sql
+CREATE TABLE IF NOT EXISTS edges (
+  edge_id TEXT PRIMARY KEY,
+  src_type TEXT NOT NULL,
+  src_id TEXT NOT NULL,
+  rel_type TEXT NOT NULL,
+  dst_type TEXT NOT NULL,
+  dst_id TEXT NOT NULL,
+  meta_json TEXT DEFAULT '{}',
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_edges_src ON edges(src_id, rel_type);
+CREATE INDEX IF NOT EXISTS idx_edges_dst ON edges(dst_id, rel_type);
+```
+
+SQLite는 `WITH CTE`, `JOIN`, `GROUP BY` 등 edge-repo의 모든 쿼리를 지원함.
+
+---
+
+## Step 3: `src/services/memory-service.ts` 정리
+
+제거할 것:
+- `DuckDBAnalyticsStore` import 및 인스턴스
+- `SyncWorker` import 및 인스턴스
+- `analyticsStore` 관련 초기화/종료 코드
+- `analyticsEnabled` 옵션 (또는 no-op으로 유지)
+
+EdgeRepo는 SQLite DB (`this.sqliteStore.db`)를 직접 사용하도록 연결.
+
+---
+
+## Step 4: `src/core/sync-worker.ts` 제거
+
+SyncWorker는 SQLite → DuckDB 동기화 전용. DuckDB 제거 시 불필요.
+파일 삭제 또는 empty class로 대체.
+
+---
+
+## Step 5: 대시보드 Analytics API
+
+DuckDB analytics store를 사용하는 서버 API들을 확인하고
+SQLite 직접 쿼리로 교체하거나 `analyticsEnabled: false` 분기를 기본값으로 변경.
+
+---
+
+## Step 6: `package.json`에서 `duckdb` 제거
+
+```json
+// 제거
+"duckdb": "^0.10.0"
+```
+
+---
+
+## 동작 흐름 (After)
+
+```
+npm install -g claude-memory-layer
+  → duckdb 없음 → 빠르고 안정적인 설치 ✅
+
+메모리 저장/조회
+  → SQLite (primary, 변경 없음) ✅
+
+시맨틱 검색
+  → LanceDB (변경 없음) ✅
+
+Edges (task blockers 등)
+  → SQLite (기존 DuckDB 쿼리 그대로, DB만 변경) ✅
+
+대시보드 통계
+  → SQLite 직접 쿼리 ✅
+```
+
+---
+
+## 주의사항
+
+- **기존 DuckDB edges 데이터 손실**: 기존 사용자의 DuckDB edges 데이터는 마이그레이션되지 않음.
+  edges는 task blocker 등 임시적 관계 데이터이므로 손실 허용 가능.
+- **`ON CONFLICT DO NOTHING`**: SQLite와 DuckDB 모두 지원. edge-repo 쿼리 변경 불필요.
+- **better-sqlite3 동기 API**: `dbRun`/`dbAll`을 Promise로 wrapping하면 edge-repo 코드 변경 최소화.
+
+---
+
+## 검증
+
+1. `npm run build` 성공
+2. Node.js v24 환경에서 `npm install` 성공
+3. edges CRUD 동작 확인 (`/api/edges` 등)
+4. 대시보드 API 에러 없음
+5. session-start, user-prompt-submit hooks 정상 동작

package/specs/optional-duckdb/spec.md

@@ -0,0 +1,35 @@
+# Spec: DuckDB 완전 제거 → SQLite로 통합
+
+## 결론
+
+DuckDB를 **완전히 제거**하고 SQLite로 통합할 수 있다.
+
+DuckDB가 하는 일:
+1. **Edges 테이블** — 표준 SQL (INSERT/SELECT/WITH CTE/JOIN). SQLite가 동일하게 지원
+2. **Analytics Store** — SQLite 데이터 복사본. 대부분 `analyticsEnabled: false`로 이미 비활성화됨
+
+`better-sqlite3`은 이미 primary dependency이므로 새 의존성 추가 없음.
+
+## 요구사항
+
+### 기능 요구사항
+
+1. **설치 성공**: Node.js v20, v22, v24+ 모든 버전에서 `npm install -g claude-memory-layer` 성공
+2. **Edges 기능 유지**: `edge-repo.ts`의 모든 쿼리가 SQLite에서 동일하게 동작
+3. **Analytics fallback**: DuckDB analytics store 제거 후 대시보드가 SQLite 직접 쿼리로 동작
+4. **기존 핵심 기능 완전 보존**: 이벤트 저장, 임베딩, 벡터 검색, session/prompt hooks 변경 없음
+5. **SyncWorker 제거**: SQLite → DuckDB sync가 불필요해지므로 삭제
+
+### 비기능 요구사항
+
+- `duckdb` package.json에서 완전 제거
+- `npm run build` 및 TypeScript strict 통과
+- 기존 SQLite DB 데이터 마이그레이션 불필요 (edges 테이블을 SQLite로 이전 — 기존 DuckDB edges 데이터는 버려도 됨)
+
+## 성공 기준
+
+- [ ] `package.json`에서 `duckdb` 제거됨
+- [ ] `npm install -g claude-memory-layer` Node.js v24에서 성공
+- [ ] `npm run build` 통과
+- [ ] edges CRUD 기능 SQLite에서 동작
+- [ ] 대시보드 API 에러 없이 응답

package/specs/selective-tool-observation/context.md

@@ -0,0 +1,100 @@
+# Context: Selective Storage (전체 이벤트 타입 분석)
+
+## 실측 데이터 (f4d5c120 / shopping_assistant)
+> SQLite events.sqlite 직접 쿼리 기준 (10,536개)
+
+### 이벤트 구성
+
+| eventType         | count  | 비율   | avg_len |
+|-------------------|--------|--------|---------|
+| tool_observation  | 7,212  | 68.5%  | 4,166   |
+| agent_response    | 2,222  | 21.1%  | 417     |
+| user_prompt       |   948  |  9.0%  | 620     |
+| session_summary   |   154  |  1.5%  | 172     |
+
+---
+
+## 1. tool_observation 분석
+
+### 도구별 분포 (전체)
+
+| Tool         | count | avg_len | 저장 가치 |
+|--------------|-------|---------|-----------|
+| Read         | 2,285 | 4,678   | ❌ 낮음 (재현 가능) |
+| Bash         | 2,034 | 2,593   | ✅/⚠️ 조건부 |
+| Grep         | 1,338 | 1,931   | ❌ 낮음 (재현 가능) |
+| Edit         |   737 | 11,034  | ✅ 높음 (변경 기록) |
+| Write        |   323 | 5,042   | ✅ 높음 (생성 기록) |
+| Glob         |   171 | 3,733   | ❌ 낮음 (재현 가능) |
+| ToolSearch   |   133 | 301     | ❌ 낮음 (시스템 내부) |
+| Task         |   114 | 7,592   | ✅ 높음 (서브태스크 결과) |
+| Skill        |    23 | 203     | ❌ 낮음 |
+| ExitPlanMode |    10 | 5,594   | ⚠️ 조건부 |
+| EnterPlanMode|    10 | 275     | ❌ 낮음 |
+| Agent        |     6 | 8,320   | ✅ 높음 |
+| WebFetch     |     2 | 1,868   | ❌ 낮음 (재현 가능) |
+| 기타 MCP     |    ~16| -       | ⚠️ 케이스별 |
+
+### 문제
+- Read/Grep/Glob 합계 **3,794개 (52.6%)** → 모두 재현 가능, 저장 불필요
+- Bash 중 의미 없는 빈 출력 다수 존재 가능
+- 현재 제외 목록: TodoWrite, TodoRead만 (너무 좁음)
+
+---
+
+## 2. agent_response 분석
+
+### 길이 분포
+
+| 구간         | count | 비율  | 특성 |
+|--------------|-------|-------|------|
+| < 50 chars   |   608 | 27.4% | 도구 체인 전환 메시지 |
+| 50~200 chars |   587 | 26.4% | 짧은 중간 응답 |
+| 200~1k chars |   758 | 34.1% | 실질적 내용 |
+| > 1k chars   |   269 | 12.1% | 명확히 가치 있음 |
+
+### 실제 저장된 짧은 응답 예시
+
+```
+[15]  "**문제 찾았습니다!** 🎯"
+[20]  "이제 실제로 서버를 시작해보겠습니다:"
+[44]  "code-server 문제를 진단해보겠습니다. 먼저 현재 상태를 확인하겠습니다."
+[50]  "이제 ChatGraph를 수정하여 ManualQuestionService를 통합합니다."
+```
+
+→ Claude가 다음 도구를 호출하기 전에 내뱉는 **전환 문장**. 단독 retrieval 가치 없음.
+
+### 문제
+- 608개 (27%)가 50자 미만 전환 메시지 → 노이즈
+- min-length 150자 적용 시 **~53% (1,195개) 감소** 가능
+
+---
+
+## 3. user_prompt 분석
+
+### 문제: import 시 필터 미적용
+
+```
+[1]  '1', '2', '3'    ← 메뉴 번호 선택
+[2]  'go', 'go'       ← 단순 실행 명령
+[2]  '커밋', '커밋'   ← 한글 단어 2자
+[2]  '\x03\x03'       ← Ctrl+C 입력 (!!!)
+```
+
+- 188개가 15자 미만 쓰레기 입력
+- **원인**: 임포터가 shouldStorePrompt() 필터를 적용하지 않아 transcript의 모든 user 메시지 저장
+- Ctrl+C 입력까지 저장되는 것이 결정적 증거
+
+---
+
+## 전체 최적화 효과 예측
+
+| 대상 | 현재 | 감소량 | 방법 |
+|------|------|--------|------|
+| tool_obs / Read+Grep+Glob+ToolSearch | 3,927개 | -3,927 | blocklist |
+| tool_obs / Bash (empty output) | ~500개 | -500 | min-output-len |
+| tool_obs / Skill+EnterPlanMode | ~33개 | -33 | blocklist |
+| agent_response < 150자 | ~1,195개 | -1,195 | min-length |
+| user_prompt tiny (import) | 188개 | -188 | importer 필터 |
+| **합계** | **10,536개** | **약 -5,843개** | |
+| **결과** | | **→ 약 4,693개** | **-55% 감소** |