bluera-knowledge 0.9.36 → 0.9.38

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.9.38](https://github.com/blueraai/bluera-knowledge/compare/v0.9.32...v0.9.38) (2026-01-08)
+
+
+### Bug Fixes
+
+* **bridge:** kill Python process before nullifying to prevent zombie ([393dab3](https://github.com/blueraai/bluera-knowledge/commit/393dab3e45c75fd87c9ecfc1ca92e67b14526e79))
+* **bridge:** mock kill() emits exit event & attach rejection handlers before stop ([d73c6ca](https://github.com/blueraai/bluera-knowledge/commit/d73c6ca6d640c3d15bd82756cabcda832f9ae245))
+* **bridge:** stop() now waits for process to actually exit ([a92de41](https://github.com/blueraai/bluera-knowledge/commit/a92de41c89318fc106f996568ed88505352d5159))
+* **cli:** ensure destroyServices runs before process.exit ([22e4267](https://github.com/blueraai/bluera-knowledge/commit/22e4267b7b9f698de3985a89b9c2b10759cfd49c))
+* **code-unit:** brace counting now handles strings and comments ([1e857bb](https://github.com/blueraai/bluera-knowledge/commit/1e857bb297f357b97a6c067950e62495b3c8fc99))
+* **code-unit:** support complex return types in signature extraction ([3bd2467](https://github.com/blueraai/bluera-knowledge/commit/3bd24675a67e73cc74a0c718f4b5a9e86cd826fb))
+* **job:** validate PID before process.kill to prevent process group kill ([67c540f](https://github.com/blueraai/bluera-knowledge/commit/67c540fef6f2c55c5dca2c824104a91fe19aeff1))
+* **search:** apply threshold filtering after score normalization ([1ebc78e](https://github.com/blueraai/bluera-knowledge/commit/1ebc78e0e688ffde0fdbaf049f17a35d129ef055))
+* **search:** enable FTS-only search mode ([4a0f371](https://github.com/blueraai/bluera-knowledge/commit/4a0f371f0c42f80bf87e28ae0e609ac95986964d))
+* **services:** fail fast on corrupted config/registry files ([030f63c](https://github.com/blueraai/bluera-knowledge/commit/030f63c10b0a30bddcd8e9b27b291ab0f53263f1))
+* **tests:** increase timeout for exit code test in CI ([a362dcd](https://github.com/blueraai/bluera-knowledge/commit/a362dcdae32b0c19e757270e5009b0c1c5ead4e4))
+* **tests:** increase timeout for flaky store delete test ([738fb49](https://github.com/blueraai/bluera-knowledge/commit/738fb4975653703d800dee802730dedfdf9e85ba))
+* **watch:** clear pending timeouts on unwatch to prevent timer leak ([4dcafc1](https://github.com/blueraai/bluera-knowledge/commit/4dcafc14417442f6eeed0257cf185e04ae9de12b))
+* **worker:** fail fast on PID file write error ([d92ce42](https://github.com/blueraai/bluera-knowledge/commit/d92ce42eff63cee3c97056ef019f5a52ef699edd))
+* **worker:** prevent division by zero and improve cancellation handling ([b7b40ab](https://github.com/blueraai/bluera-knowledge/commit/b7b40ab950b7ad0fbbe84af243be3138b1072a72))
+
+## [0.9.37](https://github.com/blueraai/bluera-knowledge/compare/v0.9.32...v0.9.37) (2026-01-08)
+
+
+### Bug Fixes
+
+* **bridge:** kill Python process before nullifying to prevent zombie ([393dab3](https://github.com/blueraai/bluera-knowledge/commit/393dab3e45c75fd87c9ecfc1ca92e67b14526e79))
+* **bridge:** mock kill() emits exit event & attach rejection handlers before stop ([d73c6ca](https://github.com/blueraai/bluera-knowledge/commit/d73c6ca6d640c3d15bd82756cabcda832f9ae245))
+* **bridge:** stop() now waits for process to actually exit ([a92de41](https://github.com/blueraai/bluera-knowledge/commit/a92de41c89318fc106f996568ed88505352d5159))
+* **cli:** ensure destroyServices runs before process.exit ([22e4267](https://github.com/blueraai/bluera-knowledge/commit/22e4267b7b9f698de3985a89b9c2b10759cfd49c))
+* **code-unit:** brace counting now handles strings and comments ([1e857bb](https://github.com/blueraai/bluera-knowledge/commit/1e857bb297f357b97a6c067950e62495b3c8fc99))
+* **code-unit:** support complex return types in signature extraction ([3bd2467](https://github.com/blueraai/bluera-knowledge/commit/3bd24675a67e73cc74a0c718f4b5a9e86cd826fb))
+* **job:** validate PID before process.kill to prevent process group kill ([67c540f](https://github.com/blueraai/bluera-knowledge/commit/67c540fef6f2c55c5dca2c824104a91fe19aeff1))
+* **search:** apply threshold filtering after score normalization ([1ebc78e](https://github.com/blueraai/bluera-knowledge/commit/1ebc78e0e688ffde0fdbaf049f17a35d129ef055))
+* **services:** fail fast on corrupted config/registry files ([030f63c](https://github.com/blueraai/bluera-knowledge/commit/030f63c10b0a30bddcd8e9b27b291ab0f53263f1))
+* **tests:** increase timeout for exit code test in CI ([a362dcd](https://github.com/blueraai/bluera-knowledge/commit/a362dcdae32b0c19e757270e5009b0c1c5ead4e4))
+* **tests:** increase timeout for flaky store delete test ([738fb49](https://github.com/blueraai/bluera-knowledge/commit/738fb4975653703d800dee802730dedfdf9e85ba))
+* **watch:** clear pending timeouts on unwatch to prevent timer leak ([4dcafc1](https://github.com/blueraai/bluera-knowledge/commit/4dcafc14417442f6eeed0257cf185e04ae9de12b))
+* **worker:** fail fast on PID file write error ([d92ce42](https://github.com/blueraai/bluera-knowledge/commit/d92ce42eff63cee3c97056ef019f5a52ef699edd))
+* **worker:** prevent division by zero and improve cancellation handling ([b7b40ab](https://github.com/blueraai/bluera-knowledge/commit/b7b40ab950b7ad0fbbe84af243be3138b1072a72))
+
 ## [0.9.36](https://github.com/blueraai/bluera-knowledge/compare/v0.9.32...v0.9.36) (2026-01-08)
 
 

package/dist/{chunk-Z2KKVH45.js → chunk-36IFANFI.js}

@@ -4,7 +4,7 @@ import {
   createServices,
   createStoreId,
   summarizePayload
-} from "./chunk-WFNPNAAP.js";
+} from "./chunk-XJFV7AJW.js";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -1086,4 +1086,4 @@ export {
   createMCPServer,
   runMCPServer
 };
-//# sourceMappingURL=chunk-Z2KKVH45.js.map
+//# sourceMappingURL=chunk-36IFANFI.js.map

package/dist/{chunk-WFNPNAAP.js → chunk-XJFV7AJW.js}

@@ -2310,6 +2310,7 @@ var IndexService = class {
     }
     if (documents.length > 0) {
       await this.lanceStore.addDocuments(store.id, documents);
+      await this.lanceStore.createFtsIndex(store.id);
     }
     if (this.codeGraphService && sourceFiles.length > 0) {
       const graph = await this.codeGraphService.buildGraph(sourceFiles);
@@ -2839,6 +2840,33 @@ var SearchService = class {
     const lowerContent = content.toLowerCase();
     return queryTerms.filter((term) => lowerContent.includes(term)).length;
   }
+  /**
+   * Normalize scores to 0-1 range and optionally filter by threshold.
+   * This ensures threshold values match displayed scores (UX consistency).
+   *
+   * Edge case handling:
+   * - If there's only 1 result or all results have the same score, normalization
+   *   would make them all 1.0. In this case, we keep the raw scores to allow
+   *   threshold filtering to work meaningfully on absolute quality.
+   */
+  normalizeAndFilterScores(results, threshold) {
+    if (results.length === 0) return [];
+    const sorted = [...results].sort((a, b) => b.score - a.score);
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    if (first === void 0 || last === void 0) return [];
+    const maxScore = first.score;
+    const minScore = last.score;
+    const range = maxScore - minScore;
+    const normalized = range > 0 ? sorted.map((r) => ({
+      ...r,
+      score: Math.round((r.score - minScore) / range * 1e6) / 1e6
+    })) : sorted;
+    if (threshold !== void 0) {
+      return normalized.filter((r) => r.score >= threshold);
+    }
+    return normalized;
+  }
   async vectorSearch(query, stores, limit, threshold) {
     const queryVector = await this.embeddingEngine.embed(query);
     const results = [];
@@ -2853,7 +2881,8 @@ var SearchService = class {
         }))
       );
     }
-    return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    const normalized = this.normalizeAndFilterScores(results, threshold);
+    return normalized.slice(0, limit);
   }
   async ftsSearch(query, stores, limit) {
     const results = [];
@@ -2873,7 +2902,7 @@ var SearchService = class {
   async hybridSearch(query, stores, limit, threshold) {
     const intents = classifyQueryIntents(query);
     const [vectorResults, ftsResults] = await Promise.all([
-      this.vectorSearch(query, stores, limit * 2, threshold),
+      this.vectorSearch(query, stores, limit * 2),
       this.ftsSearch(query, stores, limit * 2)
     ]);
     const vectorRanks = /* @__PURE__ */ new Map();
@@ -2927,32 +2956,41 @@ var SearchService = class {
       });
     }
     const sorted = rrfScores.sort((a, b) => b.score - a.score).slice(0, limit);
+    let normalizedResults;
     if (sorted.length > 0) {
       const first = sorted[0];
       const last = sorted[sorted.length - 1];
       if (first === void 0 || last === void 0) {
-        return sorted.map((r) => ({
+        normalizedResults = sorted.map((r) => ({
           ...r.result,
           score: r.score,
           rankingMetadata: r.metadata
         }));
+      } else {
+        const maxScore = first.score;
+        const minScore = last.score;
+        const range = maxScore - minScore;
+        if (range > 0) {
+          normalizedResults = sorted.map((r) => ({
+            ...r.result,
+            score: Math.round((r.score - minScore) / range * 1e6) / 1e6,
+            rankingMetadata: r.metadata
+          }));
+        } else {
+          normalizedResults = sorted.map((r) => ({
+            ...r.result,
+            score: r.score,
+            rankingMetadata: r.metadata
+          }));
+        }
       }
-      const maxScore = first.score;
-      const minScore = last.score;
-      const range = maxScore - minScore;
-      if (range > 0) {
-        return sorted.map((r) => ({
-          ...r.result,
-          score: (r.score - minScore) / range,
-          rankingMetadata: r.metadata
-        }));
-      }
+    } else {
+      normalizedResults = [];
     }
-    return sorted.map((r) => ({
-      ...r.result,
-      score: r.score,
-      rankingMetadata: r.metadata
-    }));
+    if (threshold !== void 0) {
+      return normalizedResults.filter((r) => r.score >= threshold);
+    }
+    return normalizedResults;
   }
   async searchAllStores(query, storeIds) {
     return this.search({
@@ -4016,18 +4054,11 @@ var LanceStore = class {
     const idList = documentIds.map((id) => `"${id}"`).join(", ");
     await table.delete(`id IN (${idList})`);
   }
-  async search(storeId, vector, limit, threshold) {
+  async search(storeId, vector, limit, _threshold) {
     const table = await this.getTable(storeId);
-    let query = table.vectorSearch(vector).limit(limit);
-    if (threshold !== void 0) {
-      query = query.distanceType("cosine");
-    }
+    const query = table.vectorSearch(vector).limit(limit).distanceType("cosine");
     const results = await query.toArray();
-    return results.filter((r) => {
-      if (threshold === void 0) return true;
-      const score = 1 - r._distance;
-      return score >= threshold;
-    }).map((r) => ({
+    return results.map((r) => ({
       id: createDocumentId(r.id),
       content: r.content,
       score: 1 - r._distance,
@@ -4048,7 +4079,7 @@ var LanceStore = class {
       return results.map((r) => ({
         id: createDocumentId(r.id),
         content: r.content,
-        score: r.score,
+        score: r._score,
         // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
         metadata: JSON.parse(r.metadata)
       }));
@@ -4160,4 +4191,4 @@ export {
   createServices,
   destroyServices
 };
-//# sourceMappingURL=chunk-WFNPNAAP.js.map
+//# sourceMappingURL=chunk-XJFV7AJW.js.map