bluera-knowledge 0.33.2 → 0.34.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.33.1",
+  "version": "0.34.0",
   "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
   "author": {
     "name": "Bluera Inc",

package/.claude-plugin/settings.json

@@ -1,6 +1,4 @@
 {
-  "skill_activation": false,
   "websearch_suggestions": false,
-  "webfetch_suggestions": false,
-  "bk_read_suggestions": false
+  "webfetch_suggestions": false
 }

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 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.34.0](https://github.com/blueraai/bluera-knowledge/compare/v0.28.0...v0.34.0) (2026-03-08)
+
+
+### Features
+
+* **activation:** rewrite MCP tool descriptions and simplify hooks for proactive BK usage ([0880aa7](https://github.com/blueraai/bluera-knowledge/commit/0880aa78aa8189957555c58d6e67a562cbae13cb))
+* add statusline module with store count display ([4446501](https://github.com/blueraai/bluera-knowledge/commit/44465015a4734cd7c253bda51c98ce149561fda8))
+* **eval:** 3-agent comparison with BK Grep agent and token tracking ([b3045a8](https://github.com/blueraai/bluera-knowledge/commit/b3045a8ae7df7a2e13ecdf992ff4d1055521460b))
+* **eval:** add agent quality eval comparing with-BK vs without-BK answers ([d8c62d8](https://github.com/blueraai/bluera-knowledge/commit/d8c62d804bd10d572049f4f2a01deb30cb00ccf5))
+* **hooks:** add PostToolUse hook for WebSearch BK suggestions ([d0420b4](https://github.com/blueraai/bluera-knowledge/commit/d0420b473c73092b5e6a28be2699f5fc40e090c3))
+* **mcp:** add file count estimation and ETA to store creation responses ([3d71a30](https://github.com/blueraai/bluera-knowledge/commit/3d71a307275fa06b9810ed606583f4ec2acc5841))
+* **mcp:** add stores:pull command for git pull + re-index ([7ca809c](https://github.com/blueraai/bluera-knowledge/commit/7ca809c3675be19d9d0e29e71c5f75d4f40fce35))
+* **mcp:** optimize search-to-read workflow with store paths, relatedFiles, find-files intent, and file-based get_full_context ([4eb9be9](https://github.com/blueraai/bluera-knowledge/commit/4eb9be97598e475576603b2b9a565946197986ac))
+* search infrastructure, benchmark framework, and model registry ([285ff2f](https://github.com/blueraai/bluera-knowledge/commit/285ff2f5574c4d53b61b31e84fdec43553364e98))
+* **search:** add strong-signal FTS bypass, position-aware reranking, and query expansion ([c9b6eac](https://github.com/blueraai/bluera-knowledge/commit/c9b6eac7de9a6f17100b37879304df5a634b5559))
+* training pipeline, evaluation gate, and experiment docs ([d90b395](https://github.com/blueraai/bluera-knowledge/commit/d90b395a330f4ab09ac6d71db77d659c415aa87d))
+
+
+### Bug Fixes
+
+* **ci:** remove simple mode from validation and lower coverage threshold ([7aea1ac](https://github.com/blueraai/bluera-knowledge/commit/7aea1ac466de8ee13c6dc85c00932838d41ff829))
+* **config:** wire BK_MODEL env var override in ConfigService.load() ([be56426](https://github.com/blueraai/bluera-knowledge/commit/be564263176410c3eb1441bf85c4fdce48ddc7c4))
+* **crawl:** fix nested session error and remove simple mode ([79447b4](https://github.com/blueraai/bluera-knowledge/commit/79447b4604e54760af433deb21e177f9a71cbe8e))
+* **hooks:** drain stdin in shell hooks, register web-research hook, add settings.json ([1cff9b8](https://github.com/blueraai/bluera-knowledge/commit/1cff9b8ab38e732ffa6d9fb2de8b398fddc98302))
+* **mcp:** add runtime files to package.json files array and improve bootstrap error on corrupt cache ([e195f93](https://github.com/blueraai/bluera-knowledge/commit/e195f93a4600c65bcd0fcbb45380aaa1d32bb356))
+* **mcp:** prevent browser postinstall from crashing bootstrap ([e27fe02](https://github.com/blueraai/bluera-knowledge/commit/e27fe021bdb34c8ca5b8bf93720a176435e7973c))
+
 ## [0.33.1](https://github.com/blueraai/bluera-knowledge/compare/v0.28.0...v0.33.1) (2026-03-03)
 
 

package/dist/{chunk-OMXQBWCR.js → chunk-4S6LWHKI.js}

@@ -2,7 +2,7 @@ import {
   createLogger,
   summarizePayload,
   truncateForLog
-} from "./chunk-SROFPHRA.js";
+} from "./chunk-FYHKBCIH.js";
 
 // src/crawl/intelligent-crawler.ts
 import { EventEmitter } from "events";
@@ -798,4 +798,4 @@ export {
   getCrawlStrategy,
   IntelligentCrawler
 };
-//# sourceMappingURL=chunk-OMXQBWCR.js.map
+//# sourceMappingURL=chunk-4S6LWHKI.js.map

package/dist/{chunk-SROFPHRA.js → chunk-FYHKBCIH.js}

@@ -4951,6 +4951,32 @@ function mapSearchIntentToQueryIntent(intent) {
       return "how-to";
   }
 }
+var INTENT_EXPANSION_TERMS = {
+  "find-implementation": "source code implementation function class",
+  "find-documentation": "documentation guide tutorial example",
+  "find-usage": "usage example how to use",
+  "find-pattern": "pattern matching code structure",
+  "find-definition": "definition type interface declaration",
+  "find-files": "file module path"
+};
+function expandQueryWithIntent(query, intent) {
+  if (intent === void 0) return query;
+  const expansion = INTENT_EXPANSION_TERMS[intent];
+  return `${query} ${expansion}`;
+}
+function isStrongFtsSignal(query, ftsResults) {
+  if (ftsResults.length < 2) return false;
+  const top = ftsResults[0];
+  const second = ftsResults[1];
+  if (top === void 0 || second === void 0) return false;
+  if (second.score > 0 && top.score / second.score <= 2) return false;
+  const queryLower = query.toLowerCase();
+  const rawFile = top.metadata["file"] ?? top.metadata["path"];
+  const rawName = top.metadata["name"];
+  const filePath = typeof rawFile === "string" ? rawFile : "";
+  const name = typeof rawName === "string" ? rawName : "";
+  return filePath.toLowerCase().includes(queryLower) || name.toLowerCase().includes(queryLower);
+}
 var RRF_PRESETS = {
   code: { k: 25, vectorWeight: 0.75, ftsWeight: 0.25 },
   web: { k: 30, vectorWeight: 0.7, ftsWeight: 0.3 }
@@ -5039,7 +5065,8 @@ var SearchService = class {
     let rerankTimeMs;
     const fetchLimit = limit * 3;
     if (mode === "vector") {
-      const rawResults = await this.vectorSearchRaw(query.query, stores, fetchLimit);
+      const expandedQuery = expandQueryWithIntent(query.query, query.intent);
+      const rawResults = await this.vectorSearchRaw(expandedQuery, stores, fetchLimit);
       maxRawScore = rawResults.length > 0 ? rawResults[0]?.score ?? 0 : 0;
       allResults = this.normalizeAndFilterScores(rawResults, query.threshold).slice(0, fetchLimit);
     } else if (mode === "fts") {
@@ -5049,7 +5076,8 @@ var SearchService = class {
         query.query,
         stores,
         fetchLimit,
-        query.threshold
+        query.threshold,
+        query.intent
       );
       allResults = hybridResult.results;
       maxRawScore = hybridResult.maxRawScore;
@@ -5230,18 +5258,37 @@ var SearchService = class {
   /**
    * Internal hybrid search result with additional metadata for confidence calculation.
    */
-  async hybridSearchWithMetadata(query, stores, limit, threshold) {
+  async hybridSearchWithMetadata(query, stores, limit, threshold, searchIntent) {
     const intents = classifyQueryIntents(query);
     const envOverrides = parseSearchEnvOverrides(false);
     const candidateMultiplier = envOverrides.candidateMultiplier ?? DEFAULT_CANDIDATE_MULTIPLIER;
-    const rawVectorResults = await this.vectorSearchRaw(query, stores, limit * candidateMultiplier);
+    const ftsResults = await this.ftsSearch(query, stores, limit * candidateMultiplier);
+    if (isStrongFtsSignal(query, ftsResults)) {
+      logger4.debug(
+        { query, topScore: ftsResults[0]?.score },
+        "Strong FTS signal \u2014 skipping vector search"
+      );
+      const sorted2 = ftsResults.slice(0, limit).map((r, i) => ({
+        ...r,
+        score: Math.round((1 - i / Math.max(ftsResults.length, 1)) * 1e6) / 1e6
+      }));
+      if (threshold !== void 0) {
+        return { results: sorted2.filter((r) => r.score >= threshold), maxRawScore: 0 };
+      }
+      return { results: sorted2, maxRawScore: 0 };
+    }
+    const expandedQuery = expandQueryWithIntent(query, searchIntent);
+    const rawVectorResults = await this.vectorSearchRaw(
+      expandedQuery,
+      stores,
+      limit * candidateMultiplier
+    );
     const rawVectorScores = /* @__PURE__ */ new Map();
     rawVectorResults.forEach((r) => {
       rawVectorScores.set(r.id, r.score);
     });
     const maxRawScore = rawVectorResults.length > 0 ? rawVectorResults[0]?.score ?? 0 : 0;
     const vectorResults = this.normalizeAndFilterScores(rawVectorResults);
-    const ftsResults = await this.ftsSearch(query, stores, limit * candidateMultiplier);
     const vectorRanks = /* @__PURE__ */ new Map();
     const ftsRanks = /* @__PURE__ */ new Map();
     const allDocs = /* @__PURE__ */ new Map();
@@ -5319,10 +5366,20 @@ var SearchService = class {
       reranked.results.forEach((r) => {
         rerankedScores.set(r.id, r.rerankerScore);
       });
-      sorted = sortedAll.map((r) => ({
-        ...r,
-        rerankerScore: rerankedScores.get(r.id)
-      })).sort((a, b) => (b.rerankerScore ?? -Infinity) - (a.rerankerScore ?? -Infinity)).slice(0, limit);
+      const maxRrfScore = sortedAll[0]?.score ?? 1;
+      sorted = sortedAll.map((r, rrfRank) => {
+        const rerankerScore = rerankedScores.get(r.id);
+        if (rerankerScore === void 0) {
+          return { ...r, blendedScore: -Infinity };
+        }
+        const normalizedRrf = maxRrfScore > 0 ? r.score / maxRrfScore : 0;
+        const rrfWeight = rrfRank < 3 ? 0.7 : rrfRank < 10 ? 0.5 : 0.3;
+        const rerankerWeight = 1 - rrfWeight;
+        return {
+          ...r,
+          blendedScore: normalizedRrf * rrfWeight + rerankerScore * rerankerWeight
+        };
+      }).sort((a, b) => b.blendedScore - a.blendedScore).slice(0, limit);
     } else {
       sorted = sortedAll.slice(0, limit);
     }
@@ -7575,4 +7632,4 @@ export {
   createServices,
   destroyServices
 };
-//# sourceMappingURL=chunk-SROFPHRA.js.map
+//# sourceMappingURL=chunk-FYHKBCIH.js.map