claude-memory-layer 1.0.17 → 1.0.18

package/memory/_index.md

@@ -392,6 +392,7 @@ Generated automatically by MarkdownMirror.
 - memory/node_modules/yallist/2026-02-25.md
 - memory/node_modules/yocto-queue/2026-02-25.md
 - memory/node_modules/zod/2026-02-25.md
+- memory/session_summary/uncategorized/2026-02-26.md
 - memory/specs/20260207-dashboard-upgrade/2026-02-25.md
 - memory/specs/citations-system/2026-02-25.md
 - memory/specs/endless-mode/2026-02-25.md

package/memory/agent_response/uncategorized/2026-02-26.md

@@ -23,4 +23,154 @@
 - "챗봇이 제공할 수 없는 기능" 섹션 신규 추가 (재고, 쿠폰, 주문, 배송, 교환/반품, A/S, 회원, 색상/사이즈 옵션)
 - 챗봇이 이 상품에 대해 할 수 있는 것 명시 (설명서 기반 정보, 리뷰 분석, 방송 일정)
 
-이제 "각 색상·사이즈별 재고 가능 여부 확인해줘" 같은 제안이 생성되지 않습니다.
+이제 "각 색상·사이즈별 재고 가능 여부 확인해줘" 같은 제안이 생성되지 않습니다.
+## 2026-02-26T13:53:54.660Z | 798fb69b-1aed-469f-96e3-167b90a5e186
+- type: agent_response
+- session: bench-session-2
+문제를 파악했습니다. `retrieval_traces` 테이블은 `sqlite-event-store.ts`에서 `CREATE TABLE IF NOT EXISTS`로 정의되어 있지만, API 엔드포인트에서 사용하는 DB 인스턴스가 해당 테이블을 초기화하지 못하고 있는 것 같습니다.
+
+좀 더 정확한 원인을 확인하겠습니다.
+## 2026-02-26T13:53:54.688Z | 8519d875-d5db-4b5c-8c6b-0542fbadf52c
+- type: agent_response
+- session: bench-session-2
+원인을 찾았습니다. `sqlite-event-store.ts:56-60`에서:
+
+```typescript
+// In read-only mode, skip schema creation
+if (this.readOnly) {
+  this.initialized = true;
+  return;
+}
+```
+
+API 대시보드는 `readOnly: true`로 서비스를 생성하므로 스키마 생성을 건너뜁니다. 만약 DB가 `retrieval_traces` 테이블이 추가되기 전에 생성되었다면, read-only 모드에서는 테이블을 만들 수 없어서 에러가 발생합니다.
+
+`getRecentRetrievalTraces`와 `getRetrievalTraceStats`에서 테이블 미존재 시 빈 결과를 반환하도록 수정하겠습니다.
+## 2026-02-26T13:53:54.697Z | cc73dce3-e4db-44f1-8a44-e6e1156f5c24
+- type: agent_response
+- session: bench-session-2
+수정 완료했습니다. 빌드해서 확인하겠습니다.
+## 2026-02-26T13:53:54.706Z | 66619324-dfef-4d55-bad6-406528e4cefa
+- type: agent_response
+- session: bench-session-2
+빌드 성공했습니다.
+
+**원인**: `getServiceFromQuery()`가 `readOnly: true`로 `MemoryService`를 생성 → `initialize()`에서 read-only 모드일 때 스키마 생성을 건너뜀 → 이전 버전 DB에 `retrieval_traces` 테이블이 없으면 쿼리 시 에러 발생
+
+**수정 내용** (`sqlite-event-store.ts`):
+- `getRecentRetrievalTraces()`: `no such table` 에러 시 빈 배열 `[]` 반환
+- `getRetrievalTraceStats()`: `no such table` 에러 시 기본 빈 stats 객체 반환
+- 다른 에러는 기존대로 throw
+## 2026-02-26T13:53:54.714Z | 2ab64c5d-2185-43ab-9077-3907362a96de
+- type: agent_response
+- session: bench-session-2
+`sqlite-event-store.ts:53-60`에서 보면:
+
+```typescript
+async initialize(): Promise<void> {
+  if (this.initialized) return;
+
+  // In read-only mode, skip schema creation
+  if (this.readOnly) {
+    this.initialized = true;
+    return;
+  }
+
+  // Create all tables in a single exec...
+  sqliteExec(this.db, `CREATE TABLE IF NOT EXISTS ...`);
+}
+```
+
+**스키마 생성 시점**: `MemoryService`가 **write 모드**로 `initialize()`를 처음 호출할 때입니다.
+
+이건 실제로 MCP 플러그인이 Claude Code 세션에서 메모리를 기록할 때 발생합니다 (retrieve/store 호출 시).
+
+**문제 상황**:
+- 대시보드 API는 `readOnly: true`로 서비스를 생성 → 스키마 생성 안 함
+- 해당 프로젝트 DB가 `retrieval_traces` 테이블 추가 **이전 버전**에서 만들어졌으면, write 모드 세션이 한 번도 다시 초기화되지 않은 상태
+- 결과적으로 read-only API에서 존재하지 않는 테이블을 쿼리 → 에러
+
+**정상 흐름**: 해당 프로젝트에서 Claude Code를 한번 사용하면 write 모드 초기화가 실행되고 `CREATE TABLE IF NOT EXISTS`로 테이블이 생성됩니다. 그 이후엔 대시보드에서도 정상 조회됩니다.
+
+방금 수정은 그 사이 간극(테이블 없는 상태)에서 에러 대신 빈 결과를 반환하도록 한 것입니다.
+## 2026-02-26T13:53:54.721Z | f362a4f6-a91c-4f25-89fa-4108e6418340
+- type: agent_response
+- session: bench-session-2
+커밋 완료: `60d59c6`
+
+`getRecentRetrievalTraces()`와 `getRetrievalTraceStats()`에서 `no such table` 에러 시 빈 결과를 반환하도록 수정했습니다.
+## 2026-02-26T13:54:46.336Z | 08733485-243f-4a65-a81d-ec962bc9a1d5
+- type: agent_response
+- session: bench-session-3
+문제를 파악했습니다. `retrieval_traces` 테이블은 `sqlite-event-store.ts`에서 `CREATE TABLE IF NOT EXISTS`로 정의되어 있지만, API 엔드포인트에서 사용하는 DB 인스턴스가 해당 테이블을 초기화하지 못하고 있는 것 같습니다.
+
+좀 더 정확한 원인을 확인하겠습니다.
+## 2026-02-26T13:54:46.356Z | acc9926e-20d3-477d-8fa0-e67983db0c0c
+- type: agent_response
+- session: bench-session-3
+원인을 찾았습니다. `sqlite-event-store.ts:56-60`에서:
+
+```typescript
+// In read-only mode, skip schema creation
+if (this.readOnly) {
+  this.initialized = true;
+  return;
+}
+```
+
+API 대시보드는 `readOnly: true`로 서비스를 생성하므로 스키마 생성을 건너뜁니다. 만약 DB가 `retrieval_traces` 테이블이 추가되기 전에 생성되었다면, read-only 모드에서는 테이블을 만들 수 없어서 에러가 발생합니다.
+
+`getRecentRetrievalTraces`와 `getRetrievalTraceStats`에서 테이블 미존재 시 빈 결과를 반환하도록 수정하겠습니다.
+## 2026-02-26T13:54:46.365Z | fca49e8b-4b39-48e7-a250-bd6100f96bab
+- type: agent_response
+- session: bench-session-3
+수정 완료했습니다. 빌드해서 확인하겠습니다.
+## 2026-02-26T13:54:46.374Z | 4e471294-7597-4a58-abc9-c220ac92b4bc
+- type: agent_response
+- session: bench-session-3
+빌드 성공했습니다.
+
+**원인**: `getServiceFromQuery()`가 `readOnly: true`로 `MemoryService`를 생성 → `initialize()`에서 read-only 모드일 때 스키마 생성을 건너뜀 → 이전 버전 DB에 `retrieval_traces` 테이블이 없으면 쿼리 시 에러 발생
+
+**수정 내용** (`sqlite-event-store.ts`):
+- `getRecentRetrievalTraces()`: `no such table` 에러 시 빈 배열 `[]` 반환
+- `getRetrievalTraceStats()`: `no such table` 에러 시 기본 빈 stats 객체 반환
+- 다른 에러는 기존대로 throw
+## 2026-02-26T13:54:46.382Z | a2ece559-3e19-4553-a558-ec809b54b527
+- type: agent_response
+- session: bench-session-3
+`sqlite-event-store.ts:53-60`에서 보면:
+
+```typescript
+async initialize(): Promise<void> {
+  if (this.initialized) return;
+
+  // In read-only mode, skip schema creation
+  if (this.readOnly) {
+    this.initialized = true;
+    return;
+  }
+
+  // Create all tables in a single exec...
+  sqliteExec(this.db, `CREATE TABLE IF NOT EXISTS ...`);
+}
+```
+
+**스키마 생성 시점**: `MemoryService`가 **write 모드**로 `initialize()`를 처음 호출할 때입니다.
+
+이건 실제로 MCP 플러그인이 Claude Code 세션에서 메모리를 기록할 때 발생합니다 (retrieve/store 호출 시).
+
+**문제 상황**:
+- 대시보드 API는 `readOnly: true`로 서비스를 생성 → 스키마 생성 안 함
+- 해당 프로젝트 DB가 `retrieval_traces` 테이블 추가 **이전 버전**에서 만들어졌으면, write 모드 세션이 한 번도 다시 초기화되지 않은 상태
+- 결과적으로 read-only API에서 존재하지 않는 테이블을 쿼리 → 에러
+
+**정상 흐름**: 해당 프로젝트에서 Claude Code를 한번 사용하면 write 모드 초기화가 실행되고 `CREATE TABLE IF NOT EXISTS`로 테이블이 생성됩니다. 그 이후엔 대시보드에서도 정상 조회됩니다.
+
+방금 수정은 그 사이 간극(테이블 없는 상태)에서 에러 대신 빈 결과를 반환하도록 한 것입니다.
+## 2026-02-26T13:54:46.390Z | e21b392c-87c3-44b0-a355-2fb753804ba6
+- type: agent_response
+- session: bench-session-3
+커밋 완료: `60d59c6`
+
+`getRecentRetrievalTraces()`와 `getRetrievalTraceStats()`에서 `no such table` 에러 시 빈 결과를 반환하도록 수정했습니다.

package/memory/session_summary/uncategorized/2026-02-26.md

@@ -0,0 +1,13 @@
+
+## 2026-02-26T13:53:54.921Z | 3fa78495-3f90-45ff-a85c-43dc29ddedb7
+- type: session_summary
+- session: bench-session-2
+Session with 1 user prompts and 6 responses.
+Topics discussed:
+- 최근 변경 사항 때문에 claude code 가 느려진 원인을 분석해줘.
+## 2026-02-26T13:54:46.584Z | cb94a8e4-4a9d-4bfc-8ee5-1458f5e304e7
+- type: session_summary
+- session: bench-session-3
+Session with 1 user prompts and 6 responses.
+Topics discussed:
+- 최근 변경 사항 때문에 claude code 가 느려진 원인을 분석해줘.

package/memory/tool_observation/uncategorized/2026-02-26.md

@@ -198,4 +198,12 @@
 ## 2026-02-26T12:51:57.850Z | 3b09d82b-7fa3-4673-978e-87ec65d901dd
 - type: tool_observation
 - session: 2f324dae-7d8f-4f67-842e-acf507b79c59
-{"toolName":"Bash","toolInput":{"command":"git add src/core/sqlite-event-store.ts && git commit -m \"$(cat <<'EOF'\nfix(api): handle missing retrieval_traces table in read-only mode\n\nDashboard API creates read-only MemoryService which skips schema\ncreation. If the DB was created before retrieval_traces was added,\nqueries fail with \"no such table\". Now returns empty results gracefully.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>\nEOF\n)\"","description":"Commit retrieval_traces fix"},"toolOutput":"[main 60d59c6] fix(api): handle missing retrieval_traces table in read-only mode\n 1 file changed, 52 insertions(+), 40 deletions(-)","durationMs":0,"success":true,"metadata":{"command":"git add","turnId":"6ee6b497-8756-43c8-a208-8830a70efc1a"}}
+{"toolName":"Bash","toolInput":{"command":"git add src/core/sqlite-event-store.ts && git commit -m \"$(cat <<'EOF'\nfix(api): handle missing retrieval_traces table in read-only mode\n\nDashboard API creates read-only MemoryService which skips schema\ncreation. If the DB was created before retrieval_traces was added,\nqueries fail with \"no such table\". Now returns empty results gracefully.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>\nEOF\n)\"","description":"Commit retrieval_traces fix"},"toolOutput":"[main 60d59c6] fix(api): handle missing retrieval_traces table in read-only mode\n 1 file changed, 52 insertions(+), 40 deletions(-)","durationMs":0,"success":true,"metadata":{"command":"git add","turnId":"6ee6b497-8756-43c8-a208-8830a70efc1a"}}
+## 2026-02-26T13:53:54.436Z | 4ced656c-1426-44fd-9f2d-148c5432c1f8
+- type: tool_observation
+- session: bench-session-2
+{"toolName":"Bash","toolInput":{"cmd":"echo hello"},"toolOutput":"hello\n","durationMs":0,"success":true,"metadata":{"turnId":"ccd580af-30da-4227-8a48-6ce91c3bfeba"}}
+## 2026-02-26T13:54:46.108Z | 0fa770e5-f71d-4eda-be4d-7a6529171718
+- type: tool_observation
+- session: bench-session-3
+{"toolName":"Bash","toolInput":{"cmd":"echo hello"},"toolOutput":"hello\n","durationMs":0,"success":true,"metadata":{"turnId":"03e597c8-295a-43d8-9959-bc77607d30f8"}}

package/memory/user_prompt/uncategorized/2026-02-26.md

@@ -14,3 +14,12 @@ api/stats/retrieval-traces?limit=20
 suggested_actions 를 생성할때 
 "각 색상·사이즈별 재고 가능 여부 확인해줘"
 같이 없는 기능은 생성하지 않도록 프롬프트 개선해줘 
+
+## 2026-02-26T13:53:54.228Z | efefccef-1a9a-4e89-b1fa-b855fd8fdc85
+- type: user_prompt
+- session: bench-session-2
+최근 변경 사항 때문에 claude code 가 느려진 원인을 분석해줘.
+## 2026-02-26T13:54:45.879Z | f7fca9e1-5169-4732-8845-34fdb5e699c5
+- type: user_prompt
+- session: bench-session-3
+최근 변경 사항 때문에 claude code 가 느려진 원인을 분석해줘.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-layer",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Claude Code plugin that learns from conversations to provide personalized assistance",
   "main": "dist/index.js",
   "bin": {

package/src/hooks/session-start.ts

@@ -5,7 +5,7 @@
  */
 
 import {
-  getMemoryServiceForProject,
+  getLightweightMemoryService,
   registerSession
 } from '../services/memory-service.js';
 import type { SessionStartInput, SessionStartOutput } from '../core/types.js';
@@ -18,8 +18,8 @@ async function main(): Promise<void> {
   // Register session with project path for other hooks to find
   registerSession(input.session_id, input.cwd);
 
-  // Get project-specific memory service
-  const memoryService = getMemoryServiceForProject(input.cwd);
+  // Use lightweight service to avoid starting background workers in hook process
+  const memoryService = getLightweightMemoryService(input.session_id);
 
   try {
     // Start session in memory service
@@ -42,6 +42,12 @@ async function main(): Promise<void> {
   } catch (error) {
     console.error('Memory hook error:', error);
     console.log(JSON.stringify({ context: '' }));
+  } finally {
+    try {
+      await memoryService.close();
+    } catch {
+      // Best-effort cleanup
+    }
   }
 }