bluera-knowledge 0.11.10 → 0.11.12

package/dist/index.js

@@ -6,10 +6,10 @@ import {
   isRepoStoreDefinition,
   isWebStoreDefinition,
   runMCPServer
-} from "./chunk-AHS2EILR.js";
+} from "./chunk-5NUI6JL6.js";
 import {
   IntelligentCrawler
-} from "./chunk-TTV7P7HG.js";
+} from "./chunk-ZDEO4WJT.js";
 import {
   ASTParser,
   AdapterRegistry,
@@ -22,7 +22,7 @@ import {
   err,
   extractRepoName,
   ok
-} from "./chunk-UB3L33JF.js";
+} from "./chunk-ZZNABJMQ.js";
 import "./chunk-6FHWC36B.js";
 
 // src/index.ts

package/dist/mcp/server.js

@@ -1,8 +1,8 @@
 import {
   createMCPServer,
   runMCPServer
-} from "../chunk-AHS2EILR.js";
-import "../chunk-UB3L33JF.js";
+} from "../chunk-5NUI6JL6.js";
+import "../chunk-ZZNABJMQ.js";
 import "../chunk-6FHWC36B.js";
 export {
   createMCPServer,

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   IntelligentCrawler
-} from "../chunk-TTV7P7HG.js";
+} from "../chunk-ZDEO4WJT.js";
 import {
   JobService,
   createDocumentId,
@@ -9,7 +9,7 @@ import {
   createServices,
   createStoreId,
   shutdownLogger
-} from "../chunk-UB3L33JF.js";
+} from "../chunk-ZZNABJMQ.js";
 import "../chunk-6FHWC36B.js";
 
 // src/workers/background-worker.ts

package/package.json

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

package/scripts/validate-npm-release.sh

@@ -130,6 +130,10 @@ log "Test store: $TEST_STORE"
 log "Test folder: $TEST_FOLDER"
 log "Data directory: $DATA_DIR"
 
+# Get expected version from package.json
+EXPECTED_VERSION=$(node -p "require('$REPO_ROOT/package.json').version")
+log "Expected version: $EXPECTED_VERSION"
+
 # Install latest from npm
 log_header "Installing Latest from npm"
 log "Installing bluera-knowledge@latest globally..."
@@ -144,7 +148,24 @@ fi
 # Verify installation
 log_header "Verifying Installation"
 
-run_test_contains "bluera-knowledge --version" "0." "bluera-knowledge --version"
+# Capture and display the installed version
+INSTALLED_VERSION=$(bluera-knowledge --version 2>&1 | head -1)
+log "Installed version: $INSTALLED_VERSION"
+VERSION_TEXT="Installed: bluera-knowledge@$INSTALLED_VERSION"
+VERSION_LEN=${#VERSION_TEXT}
+PADDING=$((VERSION_LEN + 4))
+echo ""
+printf "  ╔"; printf '═%.0s' $(seq 1 $PADDING); printf "╗\n"
+printf "  ║  %s  ║\n" "$VERSION_TEXT"
+printf "  ╚"; printf '═%.0s' $(seq 1 $PADDING); printf "╝\n"
+echo ""
+
+if [ "$INSTALLED_VERSION" != "$EXPECTED_VERSION" ]; then
+    log "WARNING: Version mismatch! Expected $EXPECTED_VERSION but got $INSTALLED_VERSION"
+    log "This may indicate npm cache issues. Try: npm cache clean --force"
+fi
+
+run_test_contains "bluera-knowledge --version" "$INSTALLED_VERSION" "bluera-knowledge --version"
 
 run_test_contains "bluera-knowledge --help" "CLI tool for managing knowledge stores" "bluera-knowledge --help"
 
@@ -169,7 +190,7 @@ run_test_contains "bluera-knowledge store info" "$TEST_STORE" "bluera-knowledge
 # Test search (may return no results, but should not error)
 log_header "Testing search"
 
-run_test "bluera-knowledge search" "bluera-knowledge search 'test content' --store '$TEST_STORE' -d '$DATA_DIR' -f json"
+run_test "bluera-knowledge search" "bluera-knowledge search 'test content' --stores '$TEST_STORE' -d '$DATA_DIR' -f json"
 
 # Test index command (re-index)
 log_header "Testing index"
@@ -177,7 +198,7 @@ log_header "Testing index"
 run_test "bluera-knowledge index" "bluera-knowledge index '$TEST_STORE' -d '$DATA_DIR'"
 
 # Test search again after re-indexing
-run_test "bluera-knowledge search (after reindex)" "bluera-knowledge search 'validation' --store '$TEST_STORE' -d '$DATA_DIR' -f json"
+run_test "bluera-knowledge search (after reindex)" "bluera-knowledge search 'validation' --stores '$TEST_STORE' -d '$DATA_DIR' -f json"
 
 # Test store delete
 log_header "Testing store delete"
@@ -192,6 +213,90 @@ else
     pass "Store successfully deleted"
 fi
 
+# Test suggest command
+log_header "Testing suggest"
+
+# Create a minimal package.json for suggest to find
+echo '{"dependencies": {"lodash": "^4.0.0"}}' > "$TEST_FOLDER/package.json"
+run_test "bluera-knowledge suggest" "bluera-knowledge suggest -p '$TEST_FOLDER' -d '$DATA_DIR'"
+
+# Test sync command (should work with no definitions - returns empty result)
+log_header "Testing sync"
+
+run_test_contains "bluera-knowledge sync (no definitions)" "Sync completed" "bluera-knowledge sync -p '$TEST_FOLDER' -d '$DATA_DIR'"
+
+# Test sync with a definitions file
+mkdir -p "$TEST_FOLDER/.bluera/bluera-knowledge"
+cat > "$TEST_FOLDER/.bluera/bluera-knowledge/stores.config.json" << EOF
+{
+  "version": 1,
+  "stores": [
+    {
+      "name": "sync-test-store",
+      "type": "file",
+      "path": "."
+    }
+  ]
+}
+EOF
+run_test "bluera-knowledge sync (with definitions)" "bluera-knowledge sync -p '$TEST_FOLDER' -d '$DATA_DIR'"
+
+# Verify sync created the store
+run_test_contains "Sync created store" "sync-test-store" "bluera-knowledge stores -d '$DATA_DIR'"
+
+# Clean up sync test store
+bluera-knowledge store delete "sync-test-store" --force -d "$DATA_DIR" 2>/dev/null || true
+
+# Test serve command (start, test, stop)
+log_header "Testing serve"
+
+SERVE_PORT=19876
+SERVE_PID=""
+
+# Start server in background
+log "Starting serve on port $SERVE_PORT..."
+bluera-knowledge serve --port $SERVE_PORT -d "$DATA_DIR" &
+SERVE_PID=$!
+
+# Give it time to start
+sleep 2
+
+# Check if server is running
+if kill -0 $SERVE_PID 2>/dev/null; then
+    log "Server started with PID $SERVE_PID"
+
+    # Test health endpoint
+    if curl -s "http://localhost:$SERVE_PORT/health" | grep -q "ok"; then
+        pass "bluera-knowledge serve (health endpoint)"
+    else
+        fail "bluera-knowledge serve (health endpoint not responding)"
+    fi
+
+    # Stop server
+    kill $SERVE_PID 2>/dev/null || true
+    wait $SERVE_PID 2>/dev/null || true
+    log "Server stopped"
+else
+    fail "bluera-knowledge serve (failed to start)"
+fi
+
+# Test mcp command (just verify it starts and outputs JSON-RPC)
+log_header "Testing mcp"
+
+MCP_OUTPUT=$(timeout 2 bluera-knowledge mcp -d "$DATA_DIR" 2>&1 || true)
+if echo "$MCP_OUTPUT" | grep -qE "(jsonrpc|ready|listening|MCP)" 2>/dev/null || [ $? -eq 124 ]; then
+    # Timeout (124) is expected - MCP keeps running until killed
+    pass "bluera-knowledge mcp (starts without error)"
+else
+    # Even if it times out or produces no output, as long as it didn't crash
+    if [ -z "$MCP_OUTPUT" ]; then
+        pass "bluera-knowledge mcp (starts without error)"
+    else
+        log "MCP output: $MCP_OUTPUT"
+        fail "bluera-knowledge mcp (unexpected output)"
+    fi
+fi
+
 # Summary
 log_header "Validation Summary"
 log "Tests run:    $TESTS_RUN"

package/src/scripts/validate-npm-release.test.ts

@@ -52,4 +52,19 @@ describe('validate-npm-release.sh', () => {
 
     expect(hasSilentRedirect).toBe(false);
   });
+
+  it('logs expected and installed versions for debugging', () => {
+    // Script should log both expected (from package.json) and installed versions
+    // This helps diagnose version mismatch issues from npm cache
+    expect(scriptContent).toContain('EXPECTED_VERSION');
+    expect(scriptContent).toContain('INSTALLED_VERSION');
+    expect(scriptContent).toContain('Expected version:');
+    expect(scriptContent).toContain('Installed version:');
+  });
+
+  it('warns on version mismatch', () => {
+    // Script should warn if installed version differs from expected
+    expect(scriptContent).toContain('Version mismatch');
+    expect(scriptContent).toContain('npm cache');
+  });
 });

package/src/services/search.service.test.ts

@@ -2186,43 +2186,11 @@ describe('SearchService Environment Variables', () => {
     vi.unstubAllEnvs();
   });
 
-  it('throws if SEARCH_CONFIDENCE_HIGH is not set', async () => {
+  it('uses default values when env vars are not set', async () => {
+    // Clear env vars to test defaults
     vi.stubEnv('SEARCH_CONFIDENCE_HIGH', undefined as unknown as string);
-    vi.stubEnv('SEARCH_CONFIDENCE_MEDIUM', '0.3');
-    vi.stubEnv('SEARCH_TEST_FILE_BOOST', '0.5');
-
-    const tempDir = await mkdtemp(join(tmpdir(), 'search-env-test-'));
-    const lanceStore = new LanceStore(tempDir);
-    const embeddingEngine = new EmbeddingEngine();
-    await embeddingEngine.initialize();
-
-    const storeId = createStoreId('env-test-store');
-    await lanceStore.initialize(storeId);
-
-    const text = 'test document';
-    const vector = await embeddingEngine.embed(text);
-    await lanceStore.addDocuments(storeId, [
-      {
-        id: createDocumentId('doc-1'),
-        content: text,
-        vector,
-        metadata: { type: 'file', storeId, indexedAt: new Date() },
-      },
-    ]);
-
-    const searchService = new SearchService(lanceStore, embeddingEngine);
-
-    await expect(searchService.search({ query: 'test', stores: [storeId] })).rejects.toThrow(
-      'SEARCH_CONFIDENCE_HIGH environment variable is required'
-    );
-
-    await rm(tempDir, { recursive: true });
-  });
-
-  it('throws if SEARCH_CONFIDENCE_MEDIUM is not set', async () => {
-    vi.stubEnv('SEARCH_CONFIDENCE_HIGH', '0.5');
     vi.stubEnv('SEARCH_CONFIDENCE_MEDIUM', undefined as unknown as string);
-    vi.stubEnv('SEARCH_TEST_FILE_BOOST', '0.5');
+    vi.stubEnv('SEARCH_TEST_FILE_BOOST', undefined as unknown as string);
 
     const tempDir = await mkdtemp(join(tmpdir(), 'search-env-test-'));
     const lanceStore = new LanceStore(tempDir);
@@ -2245,14 +2213,15 @@ describe('SearchService Environment Variables', () => {
 
     const searchService = new SearchService(lanceStore, embeddingEngine);
 
-    await expect(searchService.search({ query: 'test', stores: [storeId] })).rejects.toThrow(
-      'SEARCH_CONFIDENCE_MEDIUM environment variable is required'
-    );
+    // Should work with defaults (0.5 for high, 0.3 for medium)
+    const results = await searchService.search({ query: 'test', stores: [storeId] });
+    expect(results.results.length).toBeGreaterThan(0);
+    expect(results.confidence).toBeDefined();
 
     await rm(tempDir, { recursive: true });
   });
 
-  it('throws if SEARCH_TEST_FILE_BOOST is not set when ranking test files', async () => {
+  it('uses default test file boost when env var is not set', async () => {
     vi.stubEnv('SEARCH_CONFIDENCE_HIGH', '0.5');
     vi.stubEnv('SEARCH_CONFIDENCE_MEDIUM', '0.3');
     vi.stubEnv('SEARCH_TEST_FILE_BOOST', undefined as unknown as string);
@@ -2278,16 +2247,16 @@ describe('SearchService Environment Variables', () => {
           storeId,
           indexedAt: new Date(),
           filePath: 'tests/example.test.ts',
-          fileType: 'test', // Triggers SEARCH_TEST_FILE_BOOST check
+          fileType: 'test', // Uses default SEARCH_TEST_FILE_BOOST (0.5)
         },
       },
     ]);
 
     const searchService = new SearchService(lanceStore, embeddingEngine);
 
-    await expect(searchService.search({ query: 'test', stores: [storeId] })).rejects.toThrow(
-      'SEARCH_TEST_FILE_BOOST environment variable is required'
-    );
+    // Should work with default test file boost
+    const results = await searchService.search({ query: 'test', stores: [storeId] });
+    expect(results.results.length).toBeGreaterThan(0);
 
     await rm(tempDir, { recursive: true });
   });

package/src/services/search.service.ts

@@ -249,19 +249,11 @@ export class SearchService {
 
   /**
    * Calculate confidence level based on max raw vector similarity score.
-   * Configurable via environment variables.
+   * Configurable via environment variables, with sensible defaults for CLI usage.
    */
   private calculateConfidence(maxRawScore: number): SearchConfidence {
-    const highEnv = process.env['SEARCH_CONFIDENCE_HIGH'];
-    const mediumEnv = process.env['SEARCH_CONFIDENCE_MEDIUM'];
-    if (highEnv === undefined) {
-      throw new Error('SEARCH_CONFIDENCE_HIGH environment variable is required');
-    }
-    if (mediumEnv === undefined) {
-      throw new Error('SEARCH_CONFIDENCE_MEDIUM environment variable is required');
-    }
-    const highThreshold = parseFloat(highEnv);
-    const mediumThreshold = parseFloat(mediumEnv);
+    const highThreshold = parseFloat(process.env['SEARCH_CONFIDENCE_HIGH'] ?? '0.5');
+    const mediumThreshold = parseFloat(process.env['SEARCH_CONFIDENCE_MEDIUM'] ?? '0.3');
 
     if (maxRawScore >= highThreshold) return 'high';
     if (maxRawScore >= mediumThreshold) return 'medium';
@@ -759,14 +751,9 @@ export class SearchService {
       case 'source-internal':
         baseBoost = 0.75; // Internal implementation files (not too harsh)
         break;
-      case 'test': {
-        const testBoostEnv = process.env['SEARCH_TEST_FILE_BOOST'];
-        if (testBoostEnv === undefined) {
-          throw new Error('SEARCH_TEST_FILE_BOOST environment variable is required');
-        }
-        baseBoost = parseFloat(testBoostEnv);
+      case 'test':
+        baseBoost = parseFloat(process.env['SEARCH_TEST_FILE_BOOST'] ?? '0.5');
         break;
-      }
       case 'config':
         baseBoost = 0.5; // Config files rarely answer questions
         break;