bluera-knowledge 0.35.0 → 0.37.0

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 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.37.0](https://github.com/blueraai/bluera-knowledge/compare/v0.36.0...v0.37.0) (2026-03-25)
+
+
+### Features
+
+* **benchmarks:** add search benchmarking system ([0dcb70b](https://github.com/blueraai/bluera-knowledge/commit/0dcb70bbc91dc8849ef2f6eea9bb041ad1a797f3))
+* **hooks:** surface store names at every agent injection point ([96a8860](https://github.com/blueraai/bluera-knowledge/commit/96a88603b7be4596af89a8c2350e59860bcd7767))
+* **index:** expand exclusions, add metadata enrichment and progress ([88d1b7c](https://github.com/blueraai/bluera-knowledge/commit/88d1b7cdd78fca29313d4f61fe19ece29ee11290))
+* **training:** add fine-tuning and data pipeline infrastructure ([485667d](https://github.com/blueraai/bluera-knowledge/commit/485667d6f5a4db0afa799d2fd3eb3b58e241cc4f))
+* **ui:** add web admin UI, mcp-ui resources, and /bluera-knowledge:ui command ([77c6eee](https://github.com/blueraai/bluera-knowledge/commit/77c6eee4f407dc68a88d35f28ee483fd8188b9c5))
+
+
+### Bug Fixes
+
+* **suggest:** remove silent fallback — fail fast if Claude CLI unavailable ([8fec3d4](https://github.com/blueraai/bluera-knowledge/commit/8fec3d405a31061e7d3727efbbc85e723fd5a7af))
+
+## [0.36.0](https://github.com/blueraai/bluera-knowledge/compare/v0.34.0...v0.36.0) (2026-03-21)
+
+
+### Features
+
+* **activation:** directive skill description + UserPromptSubmit/Stop hooks for proactive BK usage ([64d48da](https://github.com/blueraai/bluera-knowledge/commit/64d48da2eb8e278fb7a8de0a2676f77bf6adc320))
+* **mcp:** return friendly message when add-repo URL is already indexed ([1ca0a6a](https://github.com/blueraai/bluera-knowledge/commit/1ca0a6aeb9e7646a6d3056dde60b34abd34ba10c))
+* **suggest:** AI-driven dependency importance filtering via Claude CLI ([0984039](https://github.com/blueraai/bluera-knowledge/commit/0984039d9c0bb607969f7db8d92d1e7d47cb08ff))
+
+
+### Bug Fixes
+
+* force UTF-8 encoding for Python bridge on Windows ([d6a0c9e](https://github.com/blueraai/bluera-knowledge/commit/d6a0c9eb261f65367659672ff4c21873f39505f6))
+* **hooks:** make Python hooks executable, add stdin drain, remove stale files ([219b645](https://github.com/blueraai/bluera-knowledge/commit/219b6459e955764645c8edd0c98ff0be2b9c96b8))
+* **mcp:** expand shell variables in PROJECT_ROOT to prevent literal ${PWD} directories ([2ab025f](https://github.com/blueraai/bluera-knowledge/commit/2ab025f42fb8d063cccc3dacfc47ed87d299d634))
+
 ## [0.35.0](https://github.com/blueraai/bluera-knowledge/compare/v0.34.0...v0.35.0) (2026-03-21)
 
 

package/README.md

@@ -197,7 +197,7 @@ bluera-knowledge store list
 ### 🎯 Core Features
 
 - **🔬 Smart Dependency Analysis** - Automatically scans your project to identify which libraries are most heavily used by counting import statements across all source files
-- **📊 Usage-Based Suggestions** - Ranks dependencies by actual usage frequency, showing you the top 5 most-imported packages with import counts and file counts
+- **🤖 AI-Powered Importance Filtering** - Uses Claude to select the most valuable dependencies for indexing — prioritizing core frameworks, complex APIs, and libraries likely to cause debugging issues over trivial utilities and dev tools
 - **🔍 Automatic Repository Discovery** - Queries package registries (NPM, PyPI, crates.io, Go modules) to automatically find GitHub repository URLs
 - **📦 Git Repository Indexing** - Clones and indexes dependency source code for both semantic search and direct file access
 - **📁 Local Folder Indexing** - Indexes any local content - documentation, standards, reference materials, or custom content
@@ -529,7 +529,7 @@ The plugin attempts to auto-install Playwright browsers on first use, but manual
 <details>
 <summary><b>⚠️ "Model mismatch" error</b></summary>
 
-This error occurs when a store was indexed with a different embedding model than the current configuration. As of v0.20+, stores are indexed with `bge-small-en-v1.5` (previously `all-MiniLM-L6-v2`).
+This error occurs when a store was indexed with a different embedding model than the current configuration. As of v0.25+, stores are indexed with `snowflake-arctic-embed-s` (previously `bge-small-en-v1.5`).
 
 **Solution:** Reindex the affected store:
 
@@ -732,27 +732,15 @@ This hybrid approach reduces unnecessary tool calls and context usage while main
 
 Result: Fewer tool calls, more accurate results, less context consumed.
 
-### 🎯 Skill Auto-Activation
+### 🎯 Proactive Activation
 
-Skills can automatically suggest themselves when your prompt matches certain patterns.
-
-**Toggle via slash command:**
-- `/bluera-knowledge:skill-activation` - Show current status
-- `/bluera-knowledge:skill-activation on` - Enable (default)
-- `/bluera-knowledge:skill-activation off` - Disable
-- `/bluera-knowledge:skill-activation config` - Toggle individual skills
+BK activates automatically when you work with dependencies — no manual invocation needed.
 
 **How it works:**
-When enabled, a UserPromptSubmit hook analyzes your prompt for patterns like:
-- "How does [library] work?" → suggests `knowledge-search`
-- "Should I grep or search?" → suggests `when-to-query`
-- "Too many results" → suggests `search-optimization`
-- "Multi-step workflow" → suggests `advanced-workflows`
-- "Add/delete store" → suggests `store-lifecycle`
-
-Claude evaluates each suggestion and invokes relevant skills before answering. Users who already use BK terminology are excluded (they already know the tool).
-
-**Configuration stored in:** `.bluera/bluera-knowledge/skill-activation.json` (relative to project root)
+- **Directive skill description** tells Claude to ALWAYS use BK for library/dependency questions
+- **UserPromptSubmit hook** injects a BK reminder when your prompt involves dependencies
+- **Stop hook** catches cases where dependency dirs were accessed but BK wasn't consulted
+- **Prescriptive MCP tool descriptions** ensure Claude reaches for BK search before training data
 
 ---
 

package/bun.lock

@@ -12,6 +12,7 @@
         "@hono/node-server": "^1.19.7",
         "@huggingface/transformers": "^3.8.1",
         "@lancedb/lancedb": "0.22.3",
+        "@mcp-ui/server": "^6.1.0",
         "@modelcontextprotocol/sdk": "^1.25.2",
         "apache-arrow": "^18.1.0",
         "axios": "^1.13.2",
@@ -283,8 +284,12 @@
 
     "@lancedb/lancedb-win32-x64-msvc": ["@lancedb/lancedb-win32-x64-msvc@0.22.3", "", { "os": "win32", "cpu": "x64" }, "sha512-/1feFnjz5MIhzXOEU4+1OeGwpAFYczGfefuOGZRsmGWDdt4V6/fza7Hkkxyb2OnTzqpBfy6BdW2+iBguE1JMyQ=="],
 
+    "@mcp-ui/server": ["@mcp-ui/server@6.1.0", "", { "dependencies": { "@modelcontextprotocol/ext-apps": "^0.3.1", "@modelcontextprotocol/sdk": "^1.25.1" } }, "sha512-uxv9JrzEzHfdGo/V/KTFKp5WeCOsaiAoQZ3V88jw1dSXUofONEw4rMwEvVP3612aj/unS2TIeM0o1I0asfIxtw=="],
+
     "@mixmark-io/domino": ["@mixmark-io/domino@2.2.0", "", {}, "sha512-Y28PR25bHXUg88kCV7nivXrP2Nj2RueZ3/l/jdx6J9f8J4nsEGcgX0Qe6lt7Pa+J79+kPiJU3LguR6O/6zrLOw=="],
 
+    "@modelcontextprotocol/ext-apps": ["@modelcontextprotocol/ext-apps@0.3.1", "", { "optionalDependencies": { "@oven/bun-darwin-aarch64": "^1.2.21", "@oven/bun-darwin-x64": "^1.2.21", "@oven/bun-darwin-x64-baseline": "^1.2.21", "@oven/bun-linux-aarch64": "^1.2.21", "@oven/bun-linux-aarch64-musl": "^1.2.21", "@oven/bun-linux-x64": "^1.2.21", "@oven/bun-linux-x64-baseline": "^1.2.21", "@oven/bun-linux-x64-musl": "^1.2.21", "@oven/bun-linux-x64-musl-baseline": "^1.2.21", "@oven/bun-windows-x64": "^1.2.21", "@oven/bun-windows-x64-baseline": "^1.2.21", "@rollup/rollup-darwin-arm64": "^4.53.3", "@rollup/rollup-darwin-x64": "^4.53.3", "@rollup/rollup-linux-arm64-gnu": "^4.53.3", "@rollup/rollup-linux-x64-gnu": "^4.53.3", "@rollup/rollup-win32-arm64-msvc": "^4.53.3", "@rollup/rollup-win32-x64-msvc": "^4.53.3" }, "peerDependencies": { "@modelcontextprotocol/sdk": "^1.24.0", "react": "^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0", "zod": "^3.25.0 || ^4.0.0" }, "optionalPeers": ["react", "react-dom"] }, "sha512-Iivz2KwWK8xlRbiWwFB/C4NXqE8VJBoRCbBkJCN98ST2UbQvA6kfyebcLsypiqylJS467XOOaBcI9DeQ3t+zqA=="],
+
     "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.25.3", "", { "dependencies": { "@hono/node-server": "^1.19.9", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.0.1", "express-rate-limit": "^7.5.0", "jose": "^6.1.1", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.0" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-vsAMBMERybvYgKbg/l4L1rhS7VXV1c0CtyJg72vwxONVX0l4ZfKVAnZEWTQixJGTzKnELjQ59e4NbdFDALRiAQ=="],
 
     "@mozilla/readability": ["@mozilla/readability@0.6.0", "", {}, "sha512-juG5VWh4qAivzTAeMzvY9xs9HY5rAcr2E4I7tiSSCokRFi7XIZCAu92ZkSTsIj1OPceCifL3cpfteP3pDT9/QQ=="],
@@ -303,6 +308,28 @@
 
     "@npmcli/fs": ["@npmcli/fs@5.0.0", "", { "dependencies": { "semver": "^7.3.5" } }, "sha512-7OsC1gNORBEawOa5+j2pXN9vsicaIOH5cPXxoR6fJOmH6/EXpJB2CajXOu1fPRFun2m1lktEFX11+P89hqO/og=="],
 
+    "@oven/bun-darwin-aarch64": ["@oven/bun-darwin-aarch64@1.3.11", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/8IzqSu4/OWGRs7Fs2ROzGVwJMFTBQkgAp6sAthkBYoN7OiM4rY/CpPVs2X9w9N1W61CHSkEdNKi8HrLZKfK3g=="],
+
+    "@oven/bun-darwin-x64": ["@oven/bun-darwin-x64@1.3.11", "", { "os": "darwin", "cpu": "x64" }, "sha512-TT7eUihnAzxM2tlZesusuC75PAOYKvUBgVU/Nm/lakZ/DpyuqhNkzUfcxSgmmK9IjVWzMmezLIGZl16XGCGJng=="],
+
+    "@oven/bun-darwin-x64-baseline": ["@oven/bun-darwin-x64-baseline@1.3.11", "", { "os": "darwin", "cpu": "x64" }, "sha512-CYjIHWaQG7T4phfjErHr6BiXRs0K/9DqMeiohJmuYSBF+H2m56vFslOenLCguGYQL9jeiiCZBeoVCpwjxZrMgQ=="],
+
+    "@oven/bun-linux-aarch64": ["@oven/bun-linux-aarch64@1.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-8XMLyRNxHF4jfLajkWt+F8UDxsWbzysyxQVMZKUXwoeGvaxB0rVd07r3YbgDtG8U6khhRFM3oaGp+CQ0whwmdA=="],
+
+    "@oven/bun-linux-aarch64-musl": ["@oven/bun-linux-aarch64-musl@1.3.11", "", { "os": "linux", "cpu": "arm64" }, "sha512-jBwYCLG5Eb+PqtFrc3Wp2WMYlw1Id75gUcsdP+ApCOpf5oQhHxkFWCjZmcDoioDmEhMWAiM3wtwSrTlPg+sI6Q=="],
+
+    "@oven/bun-linux-x64": ["@oven/bun-linux-x64@1.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-z3GFCk1UBzDOOiEBHL32lVP7Edi26BhOjKb6bIc0nRyabbRiyON4++GR0zmd/H5zM5S0+UcXFgCGnD+b8avTLw=="],
+
+    "@oven/bun-linux-x64-baseline": ["@oven/bun-linux-x64-baseline@1.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-KZlf1jKtf4jai8xiQv/0XRjxVVhHnw/HtUKtLdOeQpTOQ1fQFhLoz2FGGtVRd0LVa/yiRbSz9HlWIzWlmJClng=="],
+
+    "@oven/bun-linux-x64-musl": ["@oven/bun-linux-x64-musl@1.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-ADImD4yCHNpqZu718E2chWcCaAHvua90yhmpzzV6fF4zOhwkGGbPCgUWmKyJ83uz+DXaPdYxX0ttDvtolrzx3Q=="],
+
+    "@oven/bun-linux-x64-musl-baseline": ["@oven/bun-linux-x64-musl-baseline@1.3.11", "", { "os": "linux", "cpu": "x64" }, "sha512-J+qz4Al05PrNIOdj7xsWVTyx0c/gjUauG5nKV3Rrx0Q+5JO+1pPVlnfNmWbOF9pKG4f3IGad8KXJUfGMORld+Q=="],
+
+    "@oven/bun-windows-x64": ["@oven/bun-windows-x64@1.3.11", "", { "os": "win32", "cpu": "x64" }, "sha512-E51tyWDP1l0CbjZYhiUxhDGPaY8Hf5YBREx0PHBff1LM1/q3qsJ6ZvRUa8YbbOO0Ax9QP6GHjD9vf3n6bXZ7QA=="],
+
+    "@oven/bun-windows-x64-baseline": ["@oven/bun-windows-x64-baseline@1.3.11", "", { "os": "win32", "cpu": "x64" }, "sha512-cCsXK9AQ9Zf18QlVnbrFu2IKfr4sf2sfbErkF2jfCzyCO9Bnhl0KRx63zlN+Ni1xU7gcBLAssgcui5R400N2eA=="],
+
     "@oxc-resolver/binding-android-arm-eabi": ["@oxc-resolver/binding-android-arm-eabi@11.16.4", "", { "os": "android", "cpu": "arm" }, "sha512-6XUHilmj8D6Ggus+sTBp64x/DUQ7LgC/dvTDdUOt4iMQnDdSep6N1mnvVLIiG+qM5tRnNHravNzBJnUlYwRQoA=="],
 
     "@oxc-resolver/binding-android-arm64": ["@oxc-resolver/binding-android-arm64@11.16.4", "", { "os": "android", "cpu": "arm64" }, "sha512-5ODwd1F5mdkm6JIg1CNny9yxIrCzrkKpxmqas7Alw23vE0Ot8D4ykqNBW5Z/nIZkXVEo5VDmnm0sMBBIANcpeQ=="],