bluera-knowledge 0.32.0 → 0.33.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
   "author": {
     "name": "Bluera Inc",
@@ -18,7 +18,6 @@
     "vector",
     "embeddings"
   ],
-  "commands": "./commands/",
   "skills": "./skills/",
   "mcpServers": "./.mcp.json"
 }

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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.33.0](https://github.com/blueraai/bluera-knowledge/compare/v0.28.0...v0.33.0) (2026-03-01)
+
+
+### Features
+
+* 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))
+* training pipeline, evaluation gate, and experiment docs ([d90b395](https://github.com/blueraai/bluera-knowledge/commit/d90b395a330f4ab09ac6d71db77d659c415aa87d))
+
+
+### Bug Fixes
+
+* **config:** wire BK_MODEL env var override in ConfigService.load() ([be56426](https://github.com/blueraai/bluera-knowledge/commit/be564263176410c3eb1441bf85c4fdce48ddc7c4))
+* **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.32.0](https://github.com/blueraai/bluera-knowledge/compare/v0.28.0...v0.32.0) (2026-02-28)
 
 

package/hooks/hooks.json

@@ -55,6 +55,16 @@
           }
         ]
       },
+      {
+        "matcher": "WebSearch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT:-.}/hooks/posttooluse-websearch-bk.py",
+            "timeout": 2
+          }
+        ]
+      },
       {
         "matcher": "mcp__.*bluera-knowledge__search",
         "hooks": [

package/hooks/posttooluse-websearch-bk.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""
+PostToolUse hook for bluera-knowledge plugin.
+
+Fires after WebSearch tool calls. Checks if the search query relates to a
+library that is already indexed in BK, and if so reminds Claude to use BK
+search instead of relying solely on web results.
+
+Deduplicates per-project so the same store only triggers once per hour.
+"""
+
+import hashlib
+import json
+import os
+import sys
+import time
+from pathlib import Path
+
+
+# How long (seconds) before a seen store can trigger again
+DEDUP_TTL = 3600  # 1 hour
+
+# Minimum store name length to avoid false positives on short names
+MIN_STORE_NAME_LEN = 3
+
+
+def get_stores_path() -> Path | None:
+    """Get path to stores.json from project root."""
+    project_root = os.environ.get("PROJECT_ROOT") or os.environ.get("PWD")
+    if not project_root:
+        return None
+    return Path(project_root) / ".bluera" / "bluera-knowledge" / "data" / "stores.json"
+
+
+def load_stores() -> list[dict]:
+    """Load stores from stores.json. Returns empty list on error."""
+    stores_path = get_stores_path()
+    if stores_path is None or not stores_path.exists():
+        return []
+    try:
+        with open(stores_path, encoding="utf-8") as f:
+            data = json.load(f)
+        if isinstance(data, dict):
+            stores = data.get("stores", [])
+            return stores if isinstance(stores, list) else []
+        return data if isinstance(data, list) else []
+    except (json.JSONDecodeError, IOError, OSError):
+        return []
+
+
+def _dedup_path(project_root: str) -> str:
+    """Return the path to the per-project dedup file."""
+    h = hashlib.md5(project_root.encode()).hexdigest()[:8]
+    return f"/tmp/bk-websearch-{h}.json"
+
+
+def is_already_seen(store_name: str, project_root: str) -> bool:
+    """Check if this store was already flagged within the TTL."""
+    try:
+        path = _dedup_path(project_root)
+        with open(path) as f:
+            seen: dict[str, float] = json.load(f)
+        ts = seen.get(store_name, 0)
+        return (time.time() - ts) < DEDUP_TTL
+    except Exception:
+        return False
+
+
+def mark_seen(store_name: str, project_root: str) -> None:
+    """Record this store as seen, pruning expired entries."""
+    try:
+        path = _dedup_path(project_root)
+        now = time.time()
+        seen: dict[str, float] = {}
+        try:
+            with open(path) as f:
+                seen = json.load(f)
+        except Exception:
+            pass
+        seen = {k: v for k, v in seen.items() if (now - v) < DEDUP_TTL}
+        seen[store_name] = now
+        with open(path, "w") as f:
+            json.dump(seen, f)
+    except Exception:
+        pass
+
+
+def find_matching_stores(query: str, stores: list[dict]) -> list[str]:
+    """Find store names that appear in the search query."""
+    query_lower = query.lower()
+    matched = []
+    for store in stores:
+        name = store.get("name", "")
+        if len(name) < MIN_STORE_NAME_LEN:
+            continue
+        if name.lower() in query_lower:
+            matched.append(name)
+    return matched
+
+
+def main() -> int:
+    try:
+        stdin_data = sys.stdin.read()
+        if not stdin_data.strip():
+            return 0
+        hook_input = json.loads(stdin_data)
+
+        tool_name = hook_input.get("tool_name", "")
+        if tool_name != "WebSearch":
+            return 0
+
+        tool_input = hook_input.get("tool_input", {})
+        query = tool_input.get("query", "")
+        if not query:
+            return 0
+
+        stores = load_stores()
+        if not stores:
+            return 0
+
+        matched = find_matching_stores(query, stores)
+        if not matched:
+            return 0
+
+        project_root = os.environ.get("PROJECT_ROOT", os.environ.get("PWD", ""))
+
+        # Filter out already-seen stores
+        unseen = [s for s in matched if not is_already_seen(s, project_root)]
+        if not unseen:
+            return 0
+
+        for store_name in unseen:
+            mark_seen(store_name, project_root)
+
+        store_list = ", ".join(unseen)
+        message = (
+            f"You searched the web for a topic related to indexed libraries: {store_list}\n"
+            f"You have authoritative source code indexed in Bluera Knowledge.\n"
+            f"Use mcp__bluera-knowledge__search to get definitive answers from the actual source:\n"
+            f"  mcp__bluera-knowledge__search(query='{query}', intent='find-implementation')\n"
+            f"This is faster and more accurate than web results."
+        )
+
+        output = {
+            "hookSpecificOutput": {
+                "hookEventName": "PostToolUse",
+                "additionalContext": message,
+            }
+        }
+        print(json.dumps(output))
+        return 0
+
+    except Exception:
+        return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "CLI tool for managing knowledge stores with semantic search",
   "type": "module",
   "bin": {
@@ -76,7 +76,6 @@
   "files": [
     "dist/",
     "python/",
-    "commands/",
     "skills/",
     "hooks/",
     "scripts/",

package/scripts/statusline-module.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# bluera-knowledge statusline module
+# Injected into ~/.claude/statusline.sh between boundary comments:
+#   # --- bluera-knowledge ---
+#   # --- end bluera-knowledge ---
+#
+# Expected variables from parent script:
+#   PROJECT_DIR - project directory path (from statusline JSON input)
+#
+# Exports:
+#   BK_STATUS - formatted status string (e.g. " 📘●3")
+
+get_bk_status() {
+    local project_dir="$1"
+    local store_count=""
+    local config_file="$project_dir/.bluera/bluera-knowledge/stores.config.json"
+    if [ -f "$config_file" ]; then
+        store_count=$(jq '.stores | length' "$config_file" 2>/dev/null)
+        [ "$store_count" = "0" ] && store_count=""
+    fi
+
+    if pgrep -f "bluera-knowledge.*bootstrap" >/dev/null 2>&1 || \
+       pgrep -f "bluera-knowledge-mcp" >/dev/null 2>&1; then
+        printf " 📘\033[32m●\033[0m%s" "$store_count"
+    else
+        printf " 📘\033[31m●\033[0m%s" "$store_count"
+    fi
+}
+BK_STATUS=$(get_bk_status "$PROJECT_DIR")

package/skills/statusline/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: statusline
+description: Install or update the bluera-knowledge statusline module
+allowed-tools: [Read, Edit, Write, Bash]
+---
+
+Install the bluera-knowledge statusline module into the user's Claude Code statusline.
+
+## Steps
+
+1. Locate the plugin root by finding `scripts/statusline-module.sh` relative to this command file
+2. Read `scripts/statusline-module.sh` from the plugin directory to get the latest module content
+3. Read `~/.claude/statusline.sh` (or `$CLAUDE_CONFIG_DIR/statusline.sh`)
+4. If the file doesn't exist, tell the user to first set up a statusline with `/bluera-base:claude-code-statusline`
+5. Look for existing boundary comments `# --- bluera-knowledge ---` / `# --- end bluera-knowledge ---`
+6. If found: replace everything between the boundary comments (exclusive) with the module content (the function and call site from `statusline-module.sh`, excluding the shebang and header comments)
+7. If not found: insert the full boundary-commented section before the final output `printf` statements, and ensure `$BK_STATUS` is referenced in the `PLUGIN_SEG` variable
+8. Ensure the call site passes `"$PROJECT_DIR"` to `get_bk_status`
+9. Show the user the updated section and confirm success