claude-memory-layer 1.0.31 → 1.0.33

package/AGENTS.md

@@ -1,71 +0,0 @@
-# Codex / AI Agent Instructions
-
-이 저장소는 **Claude Code용 메모리 플러그인 + CLI + 로컬 대시보드 서버**입니다.
-Codex(또는 다른 코딩 에이전트)가 작업할 때 아래 규칙을 우선으로 따르세요.
-
-## Project Memory Bootstrap
-
-작업 시작/재개 전에 Claude Memory Layer MCP 도구가 사용 가능하면 먼저 프로젝트 맥락을 가져오세요.
-
-- 트리거: `continue`, `next`, `이어서`, `다음 단계`, 버그 수정, PR/merge/검증, 이전 결정/작업 맥락이 중요한 요청
-- 우선 호출: `mem-context-pack` / Hermes 도구명 `mcp_claude_memory_layer_mem_context_pack`
-- 권장 인자: `query=<현재 요청 요약>`, `projectPath=<현재 저장소 루트>`, `topK=5`, `recentLimit=30`, `sessionLimit=5`
-- MCP 도구가 없으면 막히지 말고 기존 AGENTS.md 규칙대로 진행하세요.
-- 결과는 배경 맥락으로만 사용하고, secret/token/credential 또는 transcript DB path 같은 민감한 metadata는 출력하지 마세요.
-- live agent session id를 CML `sessionId`로 넘기지 마세요. source-session 필터가 명시된 경우에만 사용하세요.
-
-## Quick Commands
-
-```bash
-npm install
-npm run build
-
-# 웹 대시보드(로컬)
-node dist/server/index.js
-# 또는
-npx claude-memory-layer dashboard
-```
-
-## Key Entry Points
-
-- `scripts/build.ts`: esbuild 기반 빌드. `dist/` 생성 + `.claude-plugin/` 및 `src/ui` 복사
-- `src/cli/index.ts`: CLI 엔트리포인트 (`bin`: `claude-memory-layer`)
-- `src/server/index.ts`: 대시보드/REST API 서버 (기본 포트 `37777`)
-- `src/server/api/chat.ts`: **외부 `claude` CLI**를 `spawn('claude', ...)`로 호출 (환경에 따라 미설치일 수 있음)
-
-## Local Side-Effects (주의)
-
-- `claude-memory-layer install` / `uninstall` 은 **사용자 머신의** `~/.claude/settings.json` 을 수정합니다.
-  - 자동 실행/테스트 목적으로 임의 실행하지 말고, 사용자가 명시적으로 요청할 때만 실행하세요.
-- 훅/CLI/서버는 기본적으로 `~/.claude-code/memory` 아래에 데이터를 읽고/씁니다.
-  - 메모리 스토리지를 삭제/초기화하는 동작은 요청 없이는 하지 마세요.
-
-## Common Pitfall: Self-dependency (반복 발생)
-
-`package.json`의 `dependencies`에 **자기 자신**을 추가하면 설치가 꼬입니다.
-
-- 금지 예: `"claude-memory-layer": "^1.0.x"`
-- 진단: `npm list claude-memory-layer` 결과가 `(empty)` 여야 정상
-- 복구:
-
-```bash
-rm package-lock.json && rm -rf node_modules
-npm install
-npm list claude-memory-layer
-```
-
-## Release / Publish Workflow
-
-1. Self-dependency 확인: `npm list claude-memory-layer` → `(empty)`
-2. 버전 업데이트: `npm version patch` 또는 `package.json` 수정
-3. 빌드: `npm run build`
-4. 배포: `npm publish --otp=<code>`
-5. 확인: `npm view claude-memory-layer versions`
-
-## Dev Notes
-
-- Node.js: `>=18` (ESM 프로젝트)
-- 스토리지: **SQLite(WAL) 기반**으로 훅(쓰기) + 서버(읽기) 동시 동작을 전제로 함
-- 테스트/정적분석 스크립트는 존재하지만, 현재 시점에서 전부 “항상 green”을 보장하지 않을 수 있으니
-  변경 전후로 실제 실행 결과를 확인하고 진행하세요.
-

package/CLAUDE.md

@@ -1,30 +0,0 @@
-# Code Memory - Project Instructions
-
-## Common Mistakes to Avoid
-
-### ⚠️ Self-dependency in package.json (반복 발생 주의!)
-- **절대로** package.json의 dependencies에 자기 자신의 패키지를 추가하지 말 것
-- 예: `"claude-memory-layer": "^1.0.x"` 같은 순환 의존성 금지
-- npm list 시 이상한 중첩 구조가 보이면 self-dependency 의심할 것
-
-#### 원인
-- `package-lock.json`에 self-dependency가 저장되면, `npm install` 시 package.json에 복원됨
-- 한번 잘못 들어가면 lock 파일 때문에 계속 복원되는 악순환 발생
-
-#### 해결 방법
-```bash
-# 1. package.json에서 self-dependency 제거
-# 2. lock 파일과 node_modules 삭제
-rm package-lock.json && rm -rf node_modules
-# 3. 새로 설치
-npm install
-# 4. 확인 (empty가 나와야 정상)
-npm list claude-memory-layer
-```
-
-## npm Publish Workflow
-1. Self-dependency 확인: `npm list claude-memory-layer` → `(empty)` 확인
-2. 버전 업데이트: package.json 직접 수정 또는 `npm version patch`
-3. 빌드: `npm run build`
-4. 배포: `npm publish --otp=<코드>`
-5. 확인: `npm view claude-memory-layer versions`

package/HANDOFF.md

@@ -1,92 +0,0 @@
-# Claude Memory Layer - 작업 핸드오프 문서
-
-## 현재 상태
-**날짜**: 2026-02-01
-**상태**: SQLite WAL 마이그레이션 완료 ✅
-
-## 문제 해결 완료
-
-### 기존 문제
-- DuckDB 다중 프로세스 동시 접근 충돌
-- 웹 대시보드 (localhost:37777)에서 500 에러
-- 훅과 서버 동시 실행 불가
-
-### 해결책: 2-tier 스토리지 아키텍처
-```
-Hooks (쓰기) ──▶ SQLite (WAL) ◀── Server (읽기)
-                     │
-                     └── 동시 접근 가능 ✅
-```
-
-## 구현된 변경사항
-
-### 새 파일
-1. **`src/core/sqlite-wrapper.ts`** - SQLite WAL 모드 래퍼
-2. **`src/core/sqlite-event-store.ts`** - SQLite 기반 EventStore
-3. **`src/core/sync-worker.ts`** - SQLite→DuckDB 동기화 워커 (미래 분석용)
-
-### 수정된 파일
-1. **`src/services/memory-service.ts`** - 이중 스토어 아키텍처 통합
-   - `sqliteStore`: Primary store (항상 사용)
-   - `analyticsStore`: DuckDB (옵션, 분석용)
-   - `analyticsEnabled` 옵션 추가
-
-2. **`src/core/index.ts`** - 새 모듈 export
-
-3. **`scripts/build.ts`** - better-sqlite3 external 추가
-
-4. **`package.json`** - better-sqlite3 의존성 추가
-
-## 테스트 결과
-```bash
-# 서버 실행 중 훅 테스트
-$ node dist/server/index.js &
-$ echo '{"session_id":"test","prompt":"test","cwd":"/tmp"}' | node dist/hooks/user-prompt-submit.js
-{"context":""}  # 성공!
-
-# 동시 실행 테스트 (5개 훅 병렬)
-All hooks completed ✅
-eventCount: 7
-```
-
-## 아키텍처 결정
-
-### Primary Store: SQLite (WAL 모드)
-- 훅에서 직접 쓰기
-- 서버에서 직접 읽기
-- WAL 모드: 다중 리더 + 단일 라이터 지원
-- 락 충돌 없음
-
-### Analytics Store: DuckDB (옵션, 미래용)
-- 복잡한 분석 쿼리용
-- 배치 동기화 (SyncWorker)
-- 현재는 비활성화
-
-## 빌드 및 실행
-
-```bash
-# 빌드
-npm run build
-
-# 서버 시작
-node dist/server/index.js
-
-# 훅 테스트 (서버 실행 중에도 가능!)
-echo '{"session_id":"test","prompt":"test","cwd":"/tmp"}' | node dist/hooks/user-prompt-submit.js
-
-# 대시보드
-open http://localhost:37777
-```
-
-## 향후 작업 (선택사항)
-
-1. **DuckDB 분석 기능 활성화**
-   - SyncWorker로 SQLite→DuckDB 동기화
-   - 복잡한 통계/분석 쿼리에 DuckDB 사용
-
-2. **Shared Store SQLite 마이그레이션**
-   - 현재: 훅에서 비활성화
-   - 향후: SQLite 기반으로 전환
-
-3. **마이그레이션 도구**
-   - 기존 DuckDB 데이터를 SQLite로 마이그레이션