claude-memory-layer 1.0.30 → 1.0.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-layer",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Claude Code plugin that learns from conversations to provide personalized assistance",
   "main": "dist/index.js",
   "bin": {
@@ -8,6 +8,13 @@
     "claude-memory-layer-mcp": "dist/mcp/index.js"
   },
   "type": "module",
+  "files": [
+    "dist/",
+    ".claude-plugin/",
+    "scripts/postinstall-embedding-backend.cjs",
+    "README.md",
+    ".env.example"
+  ],
   "scripts": {
     "build": "tsx scripts/build.ts",
     "dev": "tsx src/apps/cli/index.ts",
@@ -40,12 +47,12 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@hono/node-server": "^1.13.0",
+    "@hono/node-server": "^1.19.14",
     "@lancedb/lancedb": "^0.5.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.6.2",
     "commander": "^12.0.0",
-    "hono": "^4.0.0",
+    "hono": "^4.12.18",
     "mongodb": "^6.14.0",
     "zod": "^3.22.0"
   },

package/scripts/postinstall-embedding-backend.cjs

@@ -2,14 +2,17 @@
 'use strict';
 
 const { execFileSync, spawnSync } = require('node:child_process');
-const path = require('node:path');
-const { createRequire } = require('node:module');
 
 const EMBEDDING_BACKEND_PACKAGE_NAME = '@huggingface/transformers';
 const EMBEDDING_BACKEND_VERSION = '3.8.1';
 const EMBEDDING_BACKEND_PACKAGE = `${EMBEDDING_BACKEND_PACKAGE_NAME}@${EMBEDDING_BACKEND_VERSION}`;
 const REPAIR_GUARD_ENV = 'CLAUDE_MEMORY_LAYER_EMBEDDING_POSTINSTALL_REPAIR';
 const SKIP_ENV = 'CLAUDE_MEMORY_LAYER_SKIP_EMBEDDING_POSTINSTALL';
+const EMBEDDING_BACKEND_HEALTHCHECK_SCRIPT = `
+import('${EMBEDDING_BACKEND_PACKAGE_NAME}')
+  .then(() => undefined)
+  .catch(() => process.exit(1));
+`;
 
 function parseCudaMajor(output) {
   const releaseMatch = String(output).match(/release\s+(\d+)(?:\.\d+)?/i);
@@ -45,32 +48,30 @@ function detectCudaMajor({ env = process.env, execFileSyncImpl = execFileSync }
 
 function isSkipRequested(env = process.env) {
   if (env[SKIP_ENV] === '1' || env[REPAIR_GUARD_ENV] === '1') return true;
-  if (env.npm_config_optional === 'false') return true;
-  if (String(env.npm_config_omit || '').split(',').map((item) => item.trim()).includes('optional')) return true;
   return false;
 }
 
-function isEmbeddingBackendAvailable(rootDir = process.cwd()) {
+function isEmbeddingBackendAvailable(rootDir = process.cwd(), execFileSyncImpl = execFileSync) {
   try {
-    const requireFromRoot = createRequire(path.join(rootDir, 'package.json'));
-    requireFromRoot.resolve(EMBEDDING_BACKEND_PACKAGE_NAME);
+    execFileSyncImpl(process.execPath, ['--input-type=module', '--eval', EMBEDDING_BACKEND_HEALTHCHECK_SCRIPT], {
+      cwd: rootDir,
+      stdio: 'ignore'
+    });
     return true;
   } catch {
     return false;
   }
 }
 
-function shouldAttemptAutoInstall({ platform, arch, transformersAvailable, skipRequested }) {
-  return platform === 'linux' &&
-    arch === 'x64' &&
-    !transformersAvailable &&
-    !skipRequested;
+function shouldAttemptAutoInstall({ cudaMajor, transformersAvailable, skipRequested }) {
+  return !skipRequested && (!transformersAvailable || cudaMajor === 11);
 }
 
 function createRepairEnv(env = process.env) {
   return {
     ...env,
     ONNXRUNTIME_NODE_INSTALL_CUDA: 'skip',
+    npm_config_onnxruntime_node_install_cuda: 'skip',
     [REPAIR_GUARD_ENV]: '1'
   };
 }
@@ -91,11 +92,12 @@ function runPostinstall({
   platform = process.platform,
   arch = process.arch,
   execFileSyncImpl = execFileSync,
+  isEmbeddingBackendAvailableImpl = isEmbeddingBackendAvailable,
   spawnSyncImpl = spawnSync,
   log = console.log,
   warn = console.warn
 } = {}) {
-  const transformersAvailable = isEmbeddingBackendAvailable(rootDir);
+  const transformersAvailable = isEmbeddingBackendAvailableImpl(rootDir, execFileSyncImpl);
   const skipRequested = isSkipRequested(env);
   const cudaMajor = detectCudaMajor({ env, execFileSyncImpl });
 
@@ -103,7 +105,7 @@ function runPostinstall({
     return { attempted: false, cudaMajor, transformersAvailable, skipRequested };
   }
 
-  log('[claude-memory-layer] Optional embedding backend is missing on Linux x64. Installing CPU-only embedding backend...');
+  log('[claude-memory-layer] Embedding backend is missing or needs CUDA 11 CPU-only repair. Repairing with CPU-only ONNX Runtime...');
 
   const npmCommand = platform === 'win32' ? 'npm.cmd' : 'npm';
   const result = spawnSyncImpl(npmCommand, createNpmInstallArgs(), {
@@ -113,13 +115,13 @@ function runPostinstall({
   });
 
   if (result.error || result.status !== 0) {
-    warn('[claude-memory-layer] Optional embedding backend repair failed. Claude Memory Layer is installed, but semantic/vector embeddings may be unavailable until you run:');
+    warn('[claude-memory-layer] Required embedding backend repair failed. Semantic/vector embeddings may be unavailable until you run:');
     warn(`  ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install -g claude-memory-layer@latest`);
     if (result.error) warn(`  ${result.error.message}`);
     return { attempted: true, success: false, cudaMajor, transformersAvailable, skipRequested };
   }
 
-  log('[claude-memory-layer] Optional embedding backend installed with CPU-only ONNX Runtime.');
+  log('[claude-memory-layer] Required embedding backend repaired with CPU-only ONNX Runtime.');
   return { attempted: true, success: true, cudaMajor, transformersAvailable, skipRequested };
 }
 

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로 마이그레이션