claude-memory-layer 1.0.27 → 1.0.28

package/memory/user_prompt/uncategorized/2026-03-05.md

@@ -1,6 +0,0 @@
-
-## 2026-03-04T15:20:51.238Z | 7b3f8806-17ab-4a94-9369-a4bf669c2b12
-- type: user_prompt
-- session: 2fe5b2e5-83ea-4778-b09b-5264c550ea86
-project key : 21a039c4 에 대해서 위 개선 사항 적용해서 테스트 해보고 있는 최신      
-  데이터 기준으로 잘 활용 되고 있는지 봐줘                 

package/specs/optional-duckdb/context.md

@@ -1,77 +0,0 @@
-# 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

@@ -1,142 +0,0 @@
-# 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

@@ -1,35 +0,0 @@
-# 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 에러 없이 응답