bluera-knowledge 0.12.5 → 0.12.6

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.12.5",
+  "version": "0.12.6",
   "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
   "mcpServers": {
     "bluera-knowledge": {

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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.12.6](https://github.com/blueraai/bluera-knowledge/compare/v0.11.21...v0.12.6) (2026-01-15)
+
+
+### Features
+
+* **hooks:** add PreToolUse hooks for BK suggestions ([23d3fa4](https://github.com/blueraai/bluera-knowledge/commit/23d3fa493dd16427d6bda3ea80064622c6244bba))
+* **hooks:** add skill auto-activation system ([2b4e96b](https://github.com/blueraai/bluera-knowledge/commit/2b4e96bd29f28df63377cdaacab922d4f4321a8f))
+* **hooks:** improve skill activation with forced evaluation pattern ([f044077](https://github.com/blueraai/bluera-knowledge/commit/f044077d260b78b55a00ebf735b68a2d933f34a7)), closes [#15345](https://github.com/blueraai/bluera-knowledge/issues/15345)
+
+
+### Bug Fixes
+
+* **hooks:** use JSON output for PreToolUse hook context injection ([a73977e](https://github.com/blueraai/bluera-knowledge/commit/a73977e0f8f690d43b9d7c987300522dd501fe38))
+* **tests:** stabilize watch service tests in coverage mode ([fdf6c3a](https://github.com/blueraai/bluera-knowledge/commit/fdf6c3a478adff9e4746b54a9519184ca280f344))
+
 ## [0.12.5](https://github.com/blueraai/bluera-knowledge/compare/v0.11.21...v0.12.5) (2026-01-15)
 
 

package/commands/test-plugin.md

@@ -99,23 +99,69 @@ Execute each test in order. Mark each as PASS or FAIL.
     - Expected: Runs without error (may show no suggestions if no package.json)
     - PASS if no error thrown
 
-### Part 3: Cleanup
+### Part 3: Hook Tests
 
-11. **Delete Store**: Call MCP tool `execute` with:
+These tests verify that plugin hooks work correctly by running hook scripts directly with simulated input.
+
+11. **Hook Registration**: Verify hooks.json has expected structure
+    ```bash
+    cat .claude-plugin/hooks/hooks.json 2>/dev/null || cat hooks/hooks.json | jq -e '.hooks.PostToolUse and .hooks.UserPromptSubmit and .hooks.SessionStart'
+    ```
+    - Expected: Returns `true` (all hook types registered)
+    - PASS if command succeeds with truthy output
+
+12. **PostToolUse Hook - Library Detection**: Run hook with simulated node_modules read
+    ```bash
+    echo '{"tool_name": "Read", "tool_input": {"file_path": "/project/node_modules/express/index.js"}}' | python3 hooks/posttooluse-bk-reminder.py
+    ```
+    - Expected: JSON output with `hookSpecificOutput.additionalContext` containing "BLUERA-KNOWLEDGE REMINDER"
+    - PASS if output contains reminder text and library name "express"
+
+13. **PostToolUse Hook - Non-Library (Silent)**: Run hook with non-dependency path
+    ```bash
+    echo '{"tool_name": "Read", "tool_input": {"file_path": "/project/src/index.ts"}}' | python3 hooks/posttooluse-bk-reminder.py
+    ```
+    - Expected: Empty output (no reminder for non-library paths)
+    - PASS if output is empty
+
+14. **Skill Activation Hook - Matching Prompt**: Run hook with library-related question
+    ```bash
+    export CLAUDE_PLUGIN_ROOT="$(pwd)" && echo '{"prompt": "why does the express package throw this error?"}' | python3 hooks/skill-activation.py
+    ```
+    - Expected: JSON output with skill activation reminder for "knowledge-search"
+    - PASS if output contains "MANDATORY EVALUATION" and "knowledge-search"
+
+15. **Skill Activation Hook - Excluded Prompt**: Run hook with BK command (excluded)
+    ```bash
+    export CLAUDE_PLUGIN_ROOT="$(pwd)" && echo '{"prompt": "/bluera-knowledge:search express"}' | python3 hooks/skill-activation.py
+    ```
+    - Expected: Empty output (global exclusion matches)
+    - PASS if output is empty
+
+16. **Skill Rules File**: Verify skill-rules.json structure
+    ```bash
+    jq -e '(.skills | length) > 0 and (.globalExclusions | length) > 0' hooks/skill-rules.json
+    ```
+    - Expected: Returns `true` (valid structure with skills and exclusions)
+    - PASS if command succeeds
+
+### Part 4: Cleanup
+
+17. **Delete Store**: Call MCP tool `execute` with:
     ```json
     { "command": "store:delete", "args": { "store": "bk-test-store" } }
     ```
     - Expected: Store deleted
     - PASS if deletion succeeds
 
-12. **Remove Test Content**: Run bash command:
+18. **Remove Test Content**: Run bash command:
     ```bash
     rm -rf .bluera/bluera-knowledge/test-content
     ```
     - Expected: Directory removed
     - PASS if command succeeds
 
-13. **Verify Cleanup**: Call MCP tool `execute` with `{ command: "stores" }`
+19. **Verify Cleanup**: Call MCP tool `execute` with `{ command: "stores" }`
     - Expected: bk-test-store is NOT in the list
     - PASS if test store is gone
 
@@ -137,11 +183,17 @@ After running all tests, report results in this format:
 | 8 | /stores Command | ? |
 | 9 | /search Command | ? |
 | 10 | /suggest Command | ? |
-| 11 | Delete Store | ? |
-| 12 | Remove Test Content | ? |
-| 13 | Verify Cleanup | ? |
-
-**Result: X/13 tests passed**
+| 11 | Hook Registration | ? |
+| 12 | PostToolUse - Library Detection | ? |
+| 13 | PostToolUse - Non-Library (Silent) | ? |
+| 14 | Skill Activation - Matching | ? |
+| 15 | Skill Activation - Excluded | ? |
+| 16 | Skill Rules File | ? |
+| 17 | Delete Store | ? |
+| 18 | Remove Test Content | ? |
+| 19 | Verify Cleanup | ? |
+
+**Result: X/19 tests passed**
 
 ## Error Recovery
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.12.5",
+  "version": "0.12.6",
   "description": "CLI tool for managing knowledge stores with semantic search",
   "type": "module",
   "bin": {