bluera-knowledge 0.11.14 → 0.11.16

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 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.11.16](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.16) (2026-01-10)
+
+
+### Features
+
+* **commands:** add test-plugin command for comprehensive plugin testing ([c6eb5e7](https://github.com/blueraai/bluera-knowledge/commit/c6eb5e7762376810a9ff3e79f794f05ff0c77b97))
+* **scripts:** add post-release npm validation script ([e4c29a0](https://github.com/blueraai/bluera-knowledge/commit/e4c29a0c83907de4bc293a69a58412629457fb22))
+* **scripts:** add suggest, sync, serve, mcp tests to npm validation ([49d85da](https://github.com/blueraai/bluera-knowledge/commit/49d85dad1a89691060c12f152d644844baf6e6e6))
+* **scripts:** log expected vs installed version in validation script ([c77d039](https://github.com/blueraai/bluera-knowledge/commit/c77d039b27a3ccf54d50006af161ac4dcfea7b21))
+
+
+### Bug Fixes
+
+* **cli:** plugin-api commands now respect global options ([d3cca02](https://github.com/blueraai/bluera-knowledge/commit/d3cca02ffc679ffc187b76c7682f3cc177eabdea))
+* **commands:** move test-plugin to commands/ for plugin distribution ([0a3ff5f](https://github.com/blueraai/bluera-knowledge/commit/0a3ff5f91666db7efa213d5abd4c447fb07749fc))
+* **plugin:** properly close services after command execution ([eeaf743](https://github.com/blueraai/bluera-knowledge/commit/eeaf743750be73fd9c7a9e72440b2fd0fb5a53fa))
+* **scripts:** show real-time output in validation script ([8a4bdec](https://github.com/blueraai/bluera-knowledge/commit/8a4bdec8b63c504d34ba35bfe19da795f7f7fd07))
+* **scripts:** use mktemp for temp directories in validation script ([3107861](https://github.com/blueraai/bluera-knowledge/commit/3107861bd7a966016fde2a121469dd84756f39be))
+* **search:** add defaults for env vars so CLI works standalone ([b2d2ce5](https://github.com/blueraai/bluera-knowledge/commit/b2d2ce534e8cd2ba0fc0abdac505c912a1a76035))
+
+## [0.11.15](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.15) (2026-01-10)
+
+
+### Features
+
+* **commands:** add test-plugin command for comprehensive plugin testing ([f50c47f](https://github.com/blueraai/bluera-knowledge/commit/f50c47fee74df8c1efbe23481f05dfa33c62911f))
+* **scripts:** add post-release npm validation script ([e4c29a0](https://github.com/blueraai/bluera-knowledge/commit/e4c29a0c83907de4bc293a69a58412629457fb22))
+* **scripts:** add suggest, sync, serve, mcp tests to npm validation ([49d85da](https://github.com/blueraai/bluera-knowledge/commit/49d85dad1a89691060c12f152d644844baf6e6e6))
+* **scripts:** log expected vs installed version in validation script ([c77d039](https://github.com/blueraai/bluera-knowledge/commit/c77d039b27a3ccf54d50006af161ac4dcfea7b21))
+
+
+### Bug Fixes
+
+* **cli:** plugin-api commands now respect global options ([d3cca02](https://github.com/blueraai/bluera-knowledge/commit/d3cca02ffc679ffc187b76c7682f3cc177eabdea))
+* **plugin:** properly close services after command execution ([eeaf743](https://github.com/blueraai/bluera-knowledge/commit/eeaf743750be73fd9c7a9e72440b2fd0fb5a53fa))
+* **scripts:** show real-time output in validation script ([8a4bdec](https://github.com/blueraai/bluera-knowledge/commit/8a4bdec8b63c504d34ba35bfe19da795f7f7fd07))
+* **scripts:** use mktemp for temp directories in validation script ([3107861](https://github.com/blueraai/bluera-knowledge/commit/3107861bd7a966016fde2a121469dd84756f39be))
+* **search:** add defaults for env vars so CLI works standalone ([b2d2ce5](https://github.com/blueraai/bluera-knowledge/commit/b2d2ce534e8cd2ba0fc0abdac505c912a1a76035))
+
 ## [0.11.14](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.14) (2026-01-10)
 
 

package/README.md

@@ -1661,6 +1661,21 @@ This script:
 
 Use this to catch any packaging or runtime issues after npm publish.
 
+### 🧪 Plugin Self-Test
+
+Test all plugin functionality from within Claude Code:
+
+```
+/test-plugin
+```
+
+This command runs 13 tests covering:
+- **MCP Tools**: execute (help, stores, create, info, index), search, get_full_context
+- **Slash Commands**: /stores, /search, /suggest
+- **Cleanup**: Store deletion, artifact removal, verification
+
+The test creates temporary content, exercises all features, and cleans up automatically. Use this to verify the plugin is working correctly after installation or updates.
+
 ### 🧪 Testing Locally
 
 **Option 1: Development MCP Server (Recommended)**

package/commands/test-plugin.md

@@ -0,0 +1,148 @@
+# Test Plugin
+
+Comprehensive test of all Bluera Knowledge plugin functionality (MCP tools + slash commands).
+
+## Context
+
+!`echo "=== BK Plugin Test ===" && ls -la .bluera/bluera-knowledge/ 2>/dev/null || echo "No BK data dir yet (will be created)"`
+
+## Test Content Setup
+
+First, create test content for indexing:
+
+```bash
+mkdir -p .bluera/bluera-knowledge/test-content
+cat > .bluera/bluera-knowledge/test-content/test-file.md << 'EOF'
+# BK Plugin Test File
+
+This file contains unique test content for validating the Bluera Knowledge plugin.
+
+## Test Function
+
+The `validateBKPlugin` function performs comprehensive testing of all plugin features.
+It checks MCP connectivity, store operations, search functionality, and cleanup.
+
+Keywords: bluera-knowledge-test, plugin-validation, mcp-test
+EOF
+```
+
+## Workflow
+
+Execute each test in order. Mark each as PASS or FAIL.
+
+### Part 1: MCP Tools
+
+1. **MCP Connection**: Call MCP tool `execute` with `{ command: "help" }`
+   - Expected: Returns list of available commands
+   - PASS if response contains "Available commands"
+
+2. **List Stores (MCP)**: Call MCP tool `execute` with `{ command: "stores" }`
+   - Expected: Returns store list (may be empty initially)
+   - PASS if no error
+
+3. **Create Store**: Call MCP tool `execute` with:
+   ```json
+   { "command": "store:create", "args": { "name": "bk-test-store", "type": "file", "path": ".bluera/bluera-knowledge/test-content" } }
+   ```
+   - Expected: Store created successfully
+   - PASS if response indicates success
+
+4. **Store Info**: Call MCP tool `execute` with:
+   ```json
+   { "command": "store:info", "args": { "store": "bk-test-store" } }
+   ```
+   - Expected: Returns store metadata including name, type, path
+   - PASS if response contains store details
+
+5. **Index Store**: Call MCP tool `execute` with:
+   ```json
+   { "command": "store:index", "args": { "store": "bk-test-store" } }
+   ```
+   - Expected: Indexing completes (may take a few seconds)
+   - PASS if response indicates indexing succeeded
+
+6. **Search (MCP)**: Call MCP tool `search` with:
+   ```json
+   { "query": "validateBKPlugin", "stores": ["bk-test-store"] }
+   ```
+   - Expected: Returns results containing test content
+   - PASS if results array is non-empty and contains test file
+
+7. **Get Full Context**: If search returned results, call MCP tool `get_full_context` with:
+   ```json
+   { "resultId": "<id from search result>" }
+   ```
+   - Expected: Returns full file content
+   - PASS if response contains "BK Plugin Test File"
+
+### Part 2: Slash Commands
+
+8. **Stores Command**: Run `/bluera-knowledge:stores`
+   - Expected: Shows bk-test-store in output
+   - PASS if store is listed
+
+9. **Search Command**: Run `/bluera-knowledge:search "bluera-knowledge-test"`
+   - Expected: Returns results from test store
+   - PASS if results are shown
+
+10. **Suggest Command**: Run `/bluera-knowledge:suggest`
+    - Expected: Runs without error (may show no suggestions if no package.json)
+    - PASS if no error thrown
+
+### Part 3: Cleanup
+
+11. **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:
+    ```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" }`
+    - Expected: bk-test-store is NOT in the list
+    - PASS if test store is gone
+
+## Output Format
+
+After running all tests, report results in this format:
+
+### Plugin Test Results
+
+| # | Test | Status |
+|---|------|--------|
+| 1 | MCP Connection (help) | ? |
+| 2 | List Stores (MCP) | ? |
+| 3 | Create Store | ? |
+| 4 | Store Info | ? |
+| 5 | Index Store | ? |
+| 6 | Search (MCP) | ? |
+| 7 | Get Full Context | ? |
+| 8 | /stores Command | ? |
+| 9 | /search Command | ? |
+| 10 | /suggest Command | ? |
+| 11 | Delete Store | ? |
+| 12 | Remove Test Content | ? |
+| 13 | Verify Cleanup | ? |
+
+**Result: X/13 tests passed**
+
+## Error Recovery
+
+If tests fail partway through, clean up manually:
+
+1. Delete test store (if exists):
+   ```
+   execute → { command: "store:delete", args: { store: "bk-test-store" } }
+   ```
+
+2. Remove test content directory:
+   ```bash
+   rm -rf .bluera/bluera-knowledge/test-content
+   ```

package/package.json

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