claude-memory-layer 1.0.31 → 1.0.32

package/README.md

@@ -36,7 +36,7 @@ npx claude-memory-layer status
 ```
 
 - `install`은 **한 번만** 하면 됩니다(Claude Code hooks 등록).
-- `@huggingface/transformers`는 일반 dependency라 기본 설치에 포함됩니다. 따라서 정상 설치 후 embedding runtime 누락으로 `ERR_MODULE_NOT_FOUND`가 나는 것을 방지합니다.
+- Embedding backend은 런타임 필수 기능이지만, npm 설치 단계에서는 `optionalDependencies` + postinstall repair로 처리합니다. CUDA 11 환경에서 `onnxruntime-node`의 GPU 바이너리 자동 설치가 실패해도 패키지 설치 자체를 살리고 CPU-only backend로 복구하기 위해서입니다.
 - 이후 프로젝트별로 메모리 저장소가 자동 분리됩니다.
 - `install` / `uninstall`은 `~/.claude/settings.json`을 수정합니다.
 
@@ -48,7 +48,14 @@ Linux x64 서버에 CUDA 11이 설치되어 있으면 `@huggingface/transformers
 Error: CUDA 11 binaries are not supported by this script yet.
 ```
 
-Claude Memory Layer는 로컬 semantic/vector embedding에 필요한 `@huggingface/transformers`를 필수 dependency로 설치합니다. 이 선택은 정상 설치 후 backend 누락을 조용히 넘기지 않기 위한 것입니다. 다만 CUDA 11 환경에서는 하위 의존성 설치가 Claude Memory Layer의 postinstall repair 전에 실패할 수 있으므로, 아래처럼 CUDA 바이너리 다운로드를 건너뛰고 CPU-only ONNX Runtime으로 재설치하세요.
+Claude Memory Layer는 로컬 semantic/vector embedding에 필요한 `@huggingface/transformers`를 런타임 필수 backend로 취급합니다. 다만 CUDA 11 환경에서 하위 의존성 설치가 먼저 실패하는 문제를 피하려고 npm dependency level에서는 optional로 두고, 설치 중 postinstall repair가 `ONNXRUNTIME_NODE_INSTALL_CUDA=skip`으로 CPU-only ONNX Runtime을 자동 복구합니다. npm 로그에 `onnxruntime-node`의 CUDA 11 stack trace가 보이더라도 최종 exit code가 0이고 `claude-memory-layer --version`이 동작하면 정상입니다. 최신 버전에서는 일반적으로 아래 명령이 그대로 동작해야 합니다.
+
+```bash
+npm install -g claude-memory-layer@latest
+claude-memory-layer --version
+```
+
+만약 npm 버전/환경 차이로 같은 오류가 계속 나면 아래처럼 CUDA 바이너리 다운로드를 명시적으로 건너뛰어 재설치하세요.
 
 ```bash
 # 실패한 전역 설치가 일부 남아 있으면 먼저 제거

package/dist/cli/index.js

@@ -12937,7 +12937,7 @@ async function runMarketContextCommand(options) {
   }
 }
 var program = new Command();
-program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("1.0.31");
+program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("1.0.32");
 program.command("market-context").description("Fetch read-only DART/FRED/Finnhub context with structured MarketContextSnapshot bull/bear/risk/catalyst analysis").option("--company <name>", "Company name for DART fallback search and report subject").option("--dart-corp-code <code>", "Exact DART corp_code for issuer-specific filings").option("--symbol <ticker>", "Listed ticker for Finnhub company profile").option("--providers <list>", "Comma-separated providers: dart,fred,finnhub").option("--fred-series <list>", "Comma-separated FRED series IDs").option("--json", "Print structured JSON including analysis.marketSnapshot").option("--no-snapshot", "Disable MarketContextSnapshot and DART company snapshot analysis").action(async (options) => {
   try {
     await runMarketContextCommand(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-layer",
-  "version": "1.0.31",
+  "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",
@@ -41,7 +48,6 @@
   },
   "dependencies": {
     "@hono/node-server": "^1.19.14",
-    "@huggingface/transformers": "^3.8.1",
     "@lancedb/lancedb": "^0.5.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.6.2",
@@ -50,6 +56,9 @@
     "mongodb": "^6.14.0",
     "zod": "^3.22.0"
   },
+  "optionalDependencies": {
+    "@huggingface/transformers": "^3.8.1"
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.11.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);
@@ -48,27 +51,27 @@ function isSkipRequested(env = process.env) {
   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'
   };
 }
@@ -89,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 });
 
@@ -101,7 +105,7 @@ function runPostinstall({
     return { attempted: false, cudaMajor, transformersAvailable, skipRequested };
   }
 
-  log('[claude-memory-layer] Required embedding backend is missing on Linux x64. Repairing with CPU-only ONNX Runtime...');
+  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(), {

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