claude-memory-layer 1.0.30 → 1.0.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-layer",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "Claude Code plugin that learns from conversations to provide personalized assistance",
   "main": "dist/index.js",
   "bin": {
@@ -40,18 +40,16 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@hono/node-server": "^1.13.0",
+    "@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",
     "commander": "^12.0.0",
-    "hono": "^4.0.0",
+    "hono": "^4.12.18",
     "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

@@ -45,8 +45,6 @@ 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;
 }
 
@@ -103,7 +101,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] Required embedding backend is missing on Linux x64. Repairing with CPU-only ONNX Runtime...');
 
   const npmCommand = platform === 'win32' ? 'npm.cmd' : 'npm';
   const result = spawnSyncImpl(npmCommand, createNpmInstallArgs(), {
@@ -113,13 +111,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/src/extensions/vector/embedder.ts

@@ -208,9 +208,10 @@ export function isMissingTransformersDependencyError(error: unknown): boolean {
 export function createEmbeddingBackendUnavailableError(cause: unknown): Error & { cause?: unknown } {
   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',
       '',

package/tests/apps/postinstall-embedding-backend.test.ts

@@ -16,6 +16,7 @@ type SpawnCall = {
 type PostinstallEmbeddingBackend = {
   EMBEDDING_BACKEND_PACKAGE: string;
   parseCudaMajor(output: string): number | null;
+  isSkipRequested(env: NodeJS.ProcessEnv): boolean;
   shouldAttemptAutoInstall(input: {
     platform: NodeJS.Platform;
     arch: string;
@@ -42,20 +43,29 @@ function loadPostinstallModule(): PostinstallEmbeddingBackend {
 }
 
 describe('embedding backend postinstall repair', () => {
-  it('keeps the install-time embedding backend optional and registers postinstall repair', () => {
+  it('requires the embedding backend at install time and registers a broken-install repair hook', () => {
     const pkg = JSON.parse(readFileSync('package.json', 'utf-8')) as {
       scripts: Record<string, string>;
       dependencies?: Record<string, string>;
       optionalDependencies?: Record<string, string>;
     };
 
-    expect(pkg.dependencies).not.toHaveProperty('@huggingface/transformers');
-    expect(pkg.optionalDependencies).toMatchObject({
+    expect(pkg.dependencies).toMatchObject({
       '@huggingface/transformers': '^3.8.1'
     });
+    expect(pkg.optionalDependencies ?? {}).not.toHaveProperty('@huggingface/transformers');
     expect(pkg.scripts.postinstall).toBe('node scripts/postinstall-embedding-backend.cjs');
   });
 
+  it('only skips required-backend repair when the explicit repair guards are set', () => {
+    const postinstall = loadPostinstallModule();
+
+    expect(postinstall.isSkipRequested({ CLAUDE_MEMORY_LAYER_SKIP_EMBEDDING_POSTINSTALL: '1' })).toBe(true);
+    expect(postinstall.isSkipRequested({ CLAUDE_MEMORY_LAYER_EMBEDDING_POSTINSTALL_REPAIR: '1' })).toBe(true);
+    expect(postinstall.isSkipRequested({ npm_config_optional: 'false' })).toBe(false);
+    expect(postinstall.isSkipRequested({ npm_config_omit: 'optional' })).toBe(false);
+  });
+
   it('detects CUDA major version from nvcc output', () => {
     const postinstall = loadPostinstallModule();
 
@@ -140,7 +150,7 @@ describe('embedding backend postinstall repair', () => {
     ]);
   });
 
-  it('runs the automatic repair command when Linux x64 skipped the optional backend without detectable CUDA', () => {
+  it('runs the repair command when Linux x64 is missing the required backend without detectable CUDA', () => {
     const postinstall = loadPostinstallModule();
     const rootDir = mkdtempSync(join(tmpdir(), 'cml-postinstall-test-'));
     const calls: SpawnCall[] = [];

package/tests/extensions/embedder-warning-suppression.test.ts

@@ -20,7 +20,7 @@ describe('Embedder warning suppression', () => {
     expect(parsedConfig.embedding.openaiModel).toBe(DEFAULT_EMBEDDING_MODEL);
   });
 
-  it('turns missing optional @huggingface/transformers errors into actionable install guidance', () => {
+  it('turns missing required @huggingface/transformers errors into actionable install guidance', () => {
     const missingBackendError = Object.assign(
       new Error("Cannot find package '@huggingface/transformers' imported from /tmp/dist/cli/index.js"),
       { code: 'ERR_MODULE_NOT_FOUND' }
@@ -30,7 +30,8 @@ describe('Embedder warning suppression', () => {
     expect(isMissingTransformersDependencyError(new Error('network failure'))).toBe(false);
 
     const friendly = createEmbeddingBackendUnavailableError(missingBackendError);
-    expect(friendly.message).toContain('Optional embedding backend is not installed');
+    expect(friendly.message).toContain('Required embedding backend is not installed');
+    expect(friendly.message).toContain('Claude Memory Layer requires @huggingface/transformers');
     expect(friendly.message).toContain('ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install -g claude-memory-layer@latest');
     expect(friendly.message).toContain('ONNXRUNTIME_NODE_INSTALL_CUDA=skip npm install --no-save --no-package-lock --omit=dev @huggingface/transformers@3.8.1');
     expect(friendly.cause).toBe(missingBackendError);