bluera-knowledge 0.9.40 → 0.9.41

package/dist/mcp/server.js

@@ -1,8 +1,8 @@
 import {
   createMCPServer,
   runMCPServer
-} from "../chunk-TIGPI3BE.js";
-import "../chunk-HUEWT6U5.js";
+} from "../chunk-CUHYSPRV.js";
+import "../chunk-DWAIT2OD.js";
 import "../chunk-6FHWC36B.js";
 export {
   createMCPServer,

package/dist/workers/background-worker-cli.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   IntelligentCrawler
-} from "../chunk-IZWOEBFM.js";
+} from "../chunk-MQE32YY6.js";
 import {
   JobService,
   createDocumentId,
   createServices,
   createStoreId
-} from "../chunk-HUEWT6U5.js";
+} from "../chunk-DWAIT2OD.js";
 import "../chunk-6FHWC36B.js";
 
 // src/workers/background-worker.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.9.40",
+  "version": "0.9.41",
   "description": "CLI tool for managing knowledge stores with semantic search",
   "type": "module",
   "bin": {

package/src/cli/commands/search.test.ts

@@ -373,7 +373,7 @@ describe('search command execution', () => {
   });
 
   describe('error handling', () => {
-    it('exits with code 3 when specified store not found', async () => {
+    it('sets exitCode to 3 when specified store not found', async () => {
       const { destroyServices } = await import('../../services/index.js');
 
       mockServices.store.list.mockResolvedValue([]);
@@ -383,16 +383,20 @@ describe('search command execution', () => {
       const actionHandler = command._actionHandler;
       command.parseOptions(['--stores', 'nonexistent']);
 
-      await expect(actionHandler(['test query'])).rejects.toThrow('process.exit: 3');
+      // Reset exitCode before test
+      process.exitCode = undefined;
 
+      // Action handler completes normally but sets exitCode
+      await actionHandler(['test query']);
+
+      expect(process.exitCode).toBe(3);
       expect(consoleErrorSpy).toHaveBeenCalledWith('Error: Store not found: nonexistent');
-      expect(processExitSpy).toHaveBeenCalledWith(3);
       expect(mockServices.search.search).not.toHaveBeenCalled();
-      // Must call destroyServices before process.exit per CLAUDE.md
+      // Must call destroyServices before setting exitCode per CLAUDE.md
       expect(destroyServices).toHaveBeenCalled();
     });
 
-    it('exits with code 1 when no stores exist', async () => {
+    it('sets exitCode to 1 when no stores exist', async () => {
       const { destroyServices } = await import('../../services/index.js');
 
       mockServices.store.list.mockResolvedValue([]);
@@ -400,16 +404,20 @@ describe('search command execution', () => {
       const command = createSearchCommand(getOptions);
       const actionHandler = command._actionHandler;
 
-      await expect(actionHandler(['test query'])).rejects.toThrow('process.exit: 1');
+      // Reset exitCode before test
+      process.exitCode = undefined;
+
+      // Action handler completes normally but sets exitCode
+      await actionHandler(['test query']);
 
+      expect(process.exitCode).toBe(1);
       expect(consoleErrorSpy).toHaveBeenCalledWith('No stores to search. Create a store first.');
-      expect(processExitSpy).toHaveBeenCalledWith(1);
       expect(mockServices.search.search).not.toHaveBeenCalled();
-      // Must call destroyServices before process.exit per CLAUDE.md
+      // Must call destroyServices before setting exitCode per CLAUDE.md
       expect(destroyServices).toHaveBeenCalled();
     });
 
-    it('exits with code 3 when one of multiple stores not found', async () => {
+    it('sets exitCode to 3 when one of multiple stores not found', async () => {
       const { destroyServices } = await import('../../services/index.js');
 
       const mockStores = [{ id: createStoreId('store-1'), name: 'store1', type: 'file' as const }];
@@ -424,11 +432,15 @@ describe('search command execution', () => {
       const actionHandler = command._actionHandler;
       command.parseOptions(['--stores', 'store1,nonexistent']);
 
-      await expect(actionHandler(['test query'])).rejects.toThrow('process.exit: 3');
+      // Reset exitCode before test
+      process.exitCode = undefined;
 
+      // Action handler completes normally but sets exitCode
+      await actionHandler(['test query']);
+
+      expect(process.exitCode).toBe(3);
       expect(consoleErrorSpy).toHaveBeenCalledWith('Error: Store not found: nonexistent');
-      expect(processExitSpy).toHaveBeenCalledWith(3);
-      // Must call destroyServices before process.exit per CLAUDE.md
+      // Must call destroyServices before setting exitCode per CLAUDE.md
       expect(destroyServices).toHaveBeenCalled();
     });
   });
@@ -701,6 +713,121 @@ describe('search command execution', () => {
       );
     });
 
+    it('displays usage stats in contextual detail mode', async () => {
+      const mockStores = [{ id: createStoreId('store-1'), name: 'store1', type: 'file' as const }];
+
+      const mockSearchResponse: SearchResponse = {
+        query: 'test query',
+        mode: 'hybrid',
+        stores: [createStoreId('store-1')],
+        results: [
+          {
+            id: createDocumentId('doc-1'),
+            score: 0.95,
+            content: 'Test content',
+            metadata: {
+              type: 'file',
+              storeId: createStoreId('store-1'),
+              path: '/test/file.ts',
+            },
+            summary: {
+              type: 'function',
+              name: 'testFunction',
+              signature: 'function testFunction(): void',
+              purpose: 'Tests something',
+              location: '/test/file.ts:10',
+              relevanceReason: 'Matches test query',
+            },
+            context: {
+              interfaces: [],
+              keyImports: [],
+              relatedConcepts: [],
+              usage: {
+                calledBy: 5,
+                calls: 3,
+              },
+            },
+          },
+        ],
+        totalResults: 1,
+        timeMs: 50,
+      };
+
+      mockServices.store.list.mockResolvedValue(mockStores);
+      mockServices.lance.initialize.mockResolvedValue(undefined);
+      mockServices.search.search.mockResolvedValue(mockSearchResponse);
+
+      const command = createSearchCommand(getOptions);
+      const actionHandler = command._actionHandler;
+      command.parseOptions(['--detail', 'contextual']);
+
+      await actionHandler(['test query']);
+
+      // Should display usage stats from code graph
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringMatching(/Called by.*5/));
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringMatching(/Calls.*3/));
+    });
+
+    it('displays complete code in full detail mode', async () => {
+      const mockStores = [{ id: createStoreId('store-1'), name: 'store1', type: 'file' as const }];
+
+      const mockSearchResponse: SearchResponse = {
+        query: 'test query',
+        mode: 'hybrid',
+        stores: [createStoreId('store-1')],
+        results: [
+          {
+            id: createDocumentId('doc-1'),
+            score: 0.95,
+            content: 'Test content',
+            metadata: {
+              type: 'file',
+              storeId: createStoreId('store-1'),
+              path: '/test/file.ts',
+            },
+            summary: {
+              type: 'function',
+              name: 'testFunction',
+              signature: 'function testFunction(): void',
+              purpose: 'Tests something',
+              location: '/test/file.ts:10',
+              relevanceReason: 'Matches test query',
+            },
+            context: {
+              interfaces: [],
+              keyImports: [],
+              relatedConcepts: [],
+              usage: { calledBy: 0, calls: 0 },
+            },
+            full: {
+              completeCode: 'function testFunction(): void {\n  console.log("test");\n  return;\n}',
+              relatedCode: { callers: [], callees: [] },
+              documentation: 'This function tests something important.',
+            },
+          },
+        ],
+        totalResults: 1,
+        timeMs: 50,
+      };
+
+      mockServices.store.list.mockResolvedValue(mockStores);
+      mockServices.lance.initialize.mockResolvedValue(undefined);
+      mockServices.search.search.mockResolvedValue(mockSearchResponse);
+
+      const command = createSearchCommand(getOptions);
+      const actionHandler = command._actionHandler;
+      command.parseOptions(['--detail', 'full']);
+
+      await actionHandler(['test query']);
+
+      // Should display complete code
+      expect(consoleLogSpy).toHaveBeenCalledWith(
+        expect.stringContaining('function testFunction()')
+      );
+      // Should display documentation
+      expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('Doc:'));
+    });
+
     it('handles results with fallback path display when path is missing', async () => {
       const mockStores = [{ id: createStoreId('store-1'), name: 'store1', type: 'file' as const }];
 

package/src/cli/commands/search.ts

@@ -132,11 +132,38 @@ export function createSearchCommand(getOptions: () => GlobalOptions): Command {
                     console.log(`   ${r.summary.location}`);
                     console.log(`   ${r.summary.purpose}`);
 
+                    // Contextual: Show imports, concepts, and usage stats
                     if (r.context && options.detail !== 'minimal') {
-                      console.log(`   Imports: ${r.context.keyImports.slice(0, 3).join(', ')}`);
-                      console.log(
-                        `   Related: ${r.context.relatedConcepts.slice(0, 3).join(', ')}`
-                      );
+                      if (r.context.keyImports.length > 0) {
+                        console.log(`   Imports: ${r.context.keyImports.slice(0, 3).join(', ')}`);
+                      }
+                      if (r.context.relatedConcepts.length > 0) {
+                        console.log(
+                          `   Related: ${r.context.relatedConcepts.slice(0, 3).join(', ')}`
+                        );
+                      }
+                      // Show usage stats from code graph
+                      const { calledBy, calls } = r.context.usage;
+                      if (calledBy > 0 || calls > 0) {
+                        console.log(
+                          `   Usage: Called by ${String(calledBy)} | Calls ${String(calls)}`
+                        );
+                      }
+                    }
+
+                    // Full: Show complete code and documentation
+                    if (r.full && options.detail === 'full') {
+                      if (r.full.completeCode) {
+                        console.log(`   ---`);
+                        const codeLines = r.full.completeCode.split('\n');
+                        console.log(`   ${codeLines.slice(0, 10).join('\n   ')}`);
+                        if (codeLines.length > 10) {
+                          console.log(`   ... (truncated)`);
+                        }
+                      }
+                      if (r.full.documentation) {
+                        console.log(`   Doc: ${r.full.documentation.slice(0, 100)}`);
+                      }
                     }
 
                     console.log();
@@ -159,7 +186,9 @@ export function createSearchCommand(getOptions: () => GlobalOptions): Command {
         }
 
         if (exitCode !== 0) {
-          process.exit(exitCode);
+          // Set exit code and let Node.js exit naturally after event loop drains
+          // Using process.exit() causes mutex crashes from native code (LanceDB, tree-sitter)
+          process.exitCode = exitCode;
         }
       }
     );

package/src/db/lance.ts

@@ -162,7 +162,8 @@ export class LanceStore {
       this.connection = null;
       // Allow native threads time to complete cleanup
       // LanceDB's native code has background threads that need time
-      await new Promise((resolve) => setTimeout(resolve, 100));
+      // Increased from 100ms to 200ms for more reliable cleanup
+      await new Promise((resolve) => setTimeout(resolve, 200));
     }
   }
 

package/src/services/index.ts

@@ -87,5 +87,8 @@ export async function destroyServices(services: ServiceContainer): Promise<void>
   } catch (e) {
     logger.error({ error: e }, 'Error stopping Python bridge');
   }
+  // Additional delay to allow native threads (LanceDB, tree-sitter, transformers)
+  // to fully complete their cleanup before process exit
+  await new Promise((resolve) => setTimeout(resolve, 100));
   await shutdownLogger();
 }

package/mcp.plugin.json

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "bluera-knowledge": {
-      "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js"],
-      "env": {
-        "DATA_DIR": ".bluera/bluera-knowledge/data",
-        "CONFIG_PATH": ".bluera/bluera-knowledge/config.json"
-      }
-    }
-  }
-}

package/plugin.json

@@ -1,8 +0,0 @@
-{
-  "name": "bluera-knowledge",
-  "version": "0.9.40",
-  "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
-  "commands": "./commands",
-  "hooks": "./hooks/hooks.json",
-  "mcpServers": "./mcp.plugin.json"
-}