claude-memory-layer 1.0.30 → 1.0.32

package/README.md

@@ -36,7 +36,7 @@ npx claude-memory-layer status
 ```
 
 - `install`은 **한 번만** 하면 됩니다(Claude Code hooks 등록).
-- Linux x64에서 optional embedding backend가 빠져 있으면 설치 중 CPU-only ONNX Runtime으로 자동 복구합니다(CUDA 불필요).
+- Embedding backend은 런타임 필수 기능이지만, npm 설치 단계에서는 `optionalDependencies` + postinstall repair로 처리합니다. CUDA 11 환경에서 `onnxruntime-node`의 GPU 바이너리 자동 설치가 실패해도 패키지 설치 자체를 살리고 CPU-only backend로 복구하기 위해서입니다.
 - 이후 프로젝트별로 메모리 저장소가 자동 분리됩니다.
 - `install` / `uninstall`은 `~/.claude/settings.json`을 수정합니다.
 
@@ -48,25 +48,32 @@ Linux x64 서버에 CUDA 11이 설치되어 있으면 `@huggingface/transformers
 Error: CUDA 11 binaries are not supported by this script yet.
 ```
 
-Claude Memory Layer는 `@huggingface/transformers`를 optional dependency로 두고, 설치 후 Linux x64에서 embedding backend가 빠져 있으면 CPU-only ONNX Runtime 설정으로 자동 복구합니다. CUDA가 없어도 로컬 임베딩을 사용할 수 있고, CUDA 11을 감지하지 못하는 서버에서도 복구를 한 번 더 시도합니다. 그래서 일반적으로 사용자가 환경변수를 직접 지정할 필요는 없습니다.
+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`이 동작하면 정상입니다. 최신 버전에서는 일반적으로 아래 명령이 그대로 동작해야 합니다.
 
-만약 구버전 패키지를 설치 중이거나 postinstall 복구가 실패하면 아래처럼 수동으로 CUDA 바이너리 다운로드만 건너뛰어 재설치할 수 있습니다.
+```bash
+npm install -g claude-memory-layer@latest
+claude-memory-layer --version
+```
+
+만약 npm 버전/환경 차이로 같은 오류가 계속 나면 아래처럼 CUDA 바이너리 다운로드를 명시적으로 건너뛰어 재설치하세요.
 
 ```bash
 # 실패한 전역 설치가 일부 남아 있으면 먼저 제거
 npm uninstall -g claude-memory-layer || true
 
-# 수동 fallback: CPU-only ONNX Runtime으로 재설치
+# CPU-only ONNX Runtime으로 재설치
 ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install -g claude-memory-layer@latest
 claude-memory-layer --version
 ```
 
-로컬 checkout 개발 환경에서 구버전 의존성 설치가 같은 오류를 내면 아래처럼 수동 fallback을 사용할 수 있습니다.
+로컬 checkout 개발 환경에서 같은 오류가 나면 아래처럼 설치합니다.
 
 ```bash
 ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install
 ```
 
+이미 설치된 패키지 디렉터리에서 backend만 손상/누락된 경우에는 postinstall repair와 런타임 오류 메시지가 동일한 CPU-only 복구 명령을 안내합니다.
+
 `npm warn deprecated ...` 경고는 하위 의존성 경고이며 설치 실패 원인이 아닙니다.
 
 #### Embedding model

package/dist/cli/index.js

@@ -1693,9 +1693,10 @@ function isMissingTransformersDependencyError(error) {
 function createEmbeddingBackendUnavailableError(cause) {
   const error = new Error(
     [
-      "Optional embedding backend is not installed.",
+      "Required embedding backend is not installed.",
       "",
-      "Claude Memory Layer can run embeddings on CPU-only ONNX Runtime; CUDA is not required.",
+      "Claude Memory Layer requires @huggingface/transformers for local semantic/vector embeddings.",
+      "The backend runs on CPU-only ONNX Runtime; CUDA is not required.",
       "Reinstall globally with:",
       "  ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install -g claude-memory-layer@latest",
       "",
@@ -12936,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.30");
+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);