bluera-knowledge 0.31.0 → 0.33.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "bluera-knowledge",
+  "version": "0.33.0",
+  "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
+  "author": {
+    "name": "Bluera Inc",
+    "url": "https://bluera.ai"
+  },
+  "homepage": "https://github.com/blueraai/bluera-knowledge",
+  "repository": "https://github.com/blueraai/bluera-knowledge",
+  "license": "MIT",
+  "keywords": [
+    "search",
+    "knowledge",
+    "semantic",
+    "indexing",
+    "mcp",
+    "vector",
+    "embeddings"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "_comment": "DATA_DIR and CONFIG_PATH resolve relative to PROJECT_ROOT (${PWD})",
+  "mcpServers": {
+    "bluera-knowledge": {
+      "command": "bluera-knowledge-mcp",
+      "env": {
+        "PROJECT_ROOT": "${PWD}",
+        "DATA_DIR": ".bluera/bluera-knowledge/data",
+        "CONFIG_PATH": ".bluera/bluera-knowledge/config.json"
+      }
+    }
+  }
+}

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 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)
+
+
+### Features
+
+* **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))
+* **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.31.0](https://github.com/blueraai/bluera-knowledge/compare/v0.28.0...v0.31.0) (2026-02-26)
 
 

package/NOTICE

@@ -0,0 +1,47 @@
+Bluera Knowledge
+Copyright (c) 2024-2025 Bluera Inc
+
+This product includes software developed by third parties:
+
+---
+
+Crawl4AI
+https://github.com/unclecode/crawl4ai
+Licensed under Apache License 2.0
+
+This product includes software developed by UncleCode
+(https://x.com/unclecode) as part of the Crawl4AI project
+(https://github.com/unclecode/crawl4ai).
+
+---
+
+Playwright
+https://github.com/microsoft/playwright-python
+Licensed under Apache License 2.0
+Copyright (c) Microsoft Corporation
+
+---
+
+sharp / libvips
+https://github.com/lovell/sharp
+https://github.com/libvips/libvips
+sharp is licensed under Apache License 2.0
+libvips is licensed under LGPL-3.0-or-later
+
+---
+
+@huggingface/transformers
+https://github.com/huggingface/transformers.js
+Licensed under Apache License 2.0
+Copyright (c) Hugging Face
+
+---
+
+LanceDB
+https://github.com/lancedb/lancedb
+Licensed under Apache License 2.0
+Copyright (c) LanceDB Inc
+
+---
+
+For complete license texts, see the respective project repositories.

package/README.md

@@ -334,8 +334,8 @@ This architecture means commands provide a clean user interface while MCP tools
 
 | Tool | Purpose |
 |------|---------|
-| `search` | 🔍 Semantic vector search across all stores |
-| `get_full_context` | 📖 Retrieve complete code context for a search result |
+| `search` | 🔍 Semantic vector search across all stores (includes store paths for direct file access) |
+| `get_full_context` | 📖 Retrieve complete code context by result ID or file path |
 | `execute` | ⚡ Meta-tool for store/job management commands |
 
 The `execute` tool consolidates store and job management into a single tool with subcommands: