bluera-knowledge 0.11.4 → 0.11.6

package/.claude-plugin/plugin.json

@@ -1,5 +1,18 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.11.4",
-  "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents."
+  "version": "0.11.6",
+  "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
+  "mcpServers": {
+    "bluera-knowledge": {
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js"
+      ],
+      "env": {
+        "PROJECT_ROOT": "${PWD}",
+        "DATA_DIR": ".bluera/bluera-knowledge/data",
+        "CONFIG_PATH": ".bluera/bluera-knowledge/config.json"
+      }
+    }
+  }
 }

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 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.6](https://github.com/blueraai/bluera-knowledge/compare/v0.10.0...v0.11.6) (2026-01-10)
+
+
+### Features
+
+* add file logging to background worker for visibility ([6d7a751](https://github.com/blueraai/bluera-knowledge/commit/6d7a751de59a566c34b03b434c772ecde3770b2c))
+* **analysis:** add custom language extensibility framework with ZIL adapter ([c4dc526](https://github.com/blueraai/bluera-knowledge/commit/c4dc526467c70dbc3fb28e7e5d7620a90cc3bf95))
+* require env vars with no defaults (fail fast) ([b404cd6](https://github.com/blueraai/bluera-knowledge/commit/b404cd60374e0a7c5ace89f1ef0235bfc5c799fa))
+* **sync:** add git-committable store definitions with sync command ([5cfa925](https://github.com/blueraai/bluera-knowledge/commit/5cfa92580397f193fda75ea61197fb4c9d9d4b0a))
+
+
+### Bug Fixes
+
+* **crawl:** handle Claude CLI structured_output wrapper in intelligent crawl ([54ea74b](https://github.com/blueraai/bluera-knowledge/commit/54ea74bca6d4b7263ef11a8290416e0d66b8d37f))
+* **test:** add timeout to flaky search test ([5848b76](https://github.com/blueraai/bluera-knowledge/commit/5848b7648a547510fc2333f283ae835a6ca9efef))
+* use relative path in .mcp.json for project-level MCP config ([6d7a55e](https://github.com/blueraai/bluera-knowledge/commit/6d7a55ef86dd5ac5d568feafa3ab207faa843d46))
+
+## [0.11.5](https://github.com/blueraai/bluera-knowledge/compare/v0.10.0...v0.11.5) (2026-01-10)
+
+
+### Features
+
+* add file logging to background worker for visibility ([6d7a751](https://github.com/blueraai/bluera-knowledge/commit/6d7a751de59a566c34b03b434c772ecde3770b2c))
+* **analysis:** add custom language extensibility framework with ZIL adapter ([c4dc526](https://github.com/blueraai/bluera-knowledge/commit/c4dc526467c70dbc3fb28e7e5d7620a90cc3bf95))
+* require env vars with no defaults (fail fast) ([b404cd6](https://github.com/blueraai/bluera-knowledge/commit/b404cd60374e0a7c5ace89f1ef0235bfc5c799fa))
+* **sync:** add git-committable store definitions with sync command ([5cfa925](https://github.com/blueraai/bluera-knowledge/commit/5cfa92580397f193fda75ea61197fb4c9d9d4b0a))
+
+
+### Bug Fixes
+
+* **crawl:** handle Claude CLI structured_output wrapper in intelligent crawl ([54ea74b](https://github.com/blueraai/bluera-knowledge/commit/54ea74bca6d4b7263ef11a8290416e0d66b8d37f))
+* **test:** add timeout to flaky search test ([5848b76](https://github.com/blueraai/bluera-knowledge/commit/5848b7648a547510fc2333f283ae835a6ca9efef))
+
 ## [0.11.4](https://github.com/blueraai/bluera-knowledge/compare/v0.10.0...v0.11.4) (2026-01-10)
 
 

package/README.md

@@ -1147,7 +1147,7 @@ playwright install chromium
 
 ## 🔌 MCP Integration
 
-The plugin includes a Model Context Protocol server that exposes search tools. This is configured in `mcp.plugin.json`:
+The plugin includes a Model Context Protocol server that exposes search tools. This is configured inline in `.claude-plugin/plugin.json`:
 
 > [!IMPORTANT]
 > **Commands vs MCP Tools**: You interact with the plugin using `/bluera-knowledge:` slash commands. Behind the scenes, these commands instruct Claude Code to use MCP tools (`mcp__bluera-knowledge__*`) which handle the actual operations. Commands provide the user interface, while MCP tools are the backend that AI agents use to access your knowledge stores.
@@ -1159,6 +1159,7 @@ The plugin includes a Model Context Protocol server that exposes search tools. T
       "command": "node",
       "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js"],
       "env": {
+        "PROJECT_ROOT": "${PWD}",
         "DATA_DIR": ".bluera/bluera-knowledge/data",
         "CONFIG_PATH": ".bluera/bluera-knowledge/config.json"
       }

package/package.json

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

package/src/mcp/plugin-mcp-config.test.ts

@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Tests to verify plugin.json is correctly configured for MCP server.
+ * The MCP server must work when the plugin is installed via marketplace.
+ *
+ * Key requirements:
+ * - Must use ${CLAUDE_PLUGIN_ROOT} for server path (resolves to plugin cache)
+ * - Must set PROJECT_ROOT env var (required by server fail-fast check)
+ * - Must NOT use relative paths (would resolve to user's project, not plugin)
+ */
+describe('Plugin MCP Configuration (.claude-plugin/plugin.json)', () => {
+  const configPath = join(process.cwd(), '.claude-plugin/plugin.json');
+  const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+
+  it('has mcpServers configuration inline', () => {
+    expect(config).toHaveProperty('mcpServers');
+    expect(config.mcpServers).toHaveProperty('bluera-knowledge');
+  });
+
+  it('uses ${CLAUDE_PLUGIN_ROOT} for server path (required for plugin mode)', () => {
+    const serverConfig = config.mcpServers['bluera-knowledge'];
+    const argsString = JSON.stringify(serverConfig.args);
+
+    // CLAUDE_PLUGIN_ROOT is set by Claude Code when plugin is installed
+    // This ensures the path resolves to the plugin cache, not user's project
+    expect(argsString).toContain('${CLAUDE_PLUGIN_ROOT}');
+    expect(argsString).toContain('dist/mcp/server.js');
+  });
+
+  it('does NOT use relative paths (would break in plugin mode)', () => {
+    const serverConfig = config.mcpServers['bluera-knowledge'];
+    const argsString = JSON.stringify(serverConfig.args);
+
+    // Relative paths like ./dist would resolve to user's project directory
+    // which doesn't have the plugin's dist folder
+    expect(argsString).not.toMatch(/"\.\//);
+  });
+
+  it('sets PROJECT_ROOT environment variable (required by fail-fast server)', () => {
+    const serverConfig = config.mcpServers['bluera-knowledge'];
+
+    // PROJECT_ROOT is required since b404cd6 (fail-fast change)
+    expect(serverConfig.env).toHaveProperty('PROJECT_ROOT');
+    expect(serverConfig.env['PROJECT_ROOT']).toBe('${PWD}');
+  });
+});
+
+/**
+ * Tests to ensure .mcp.json is NOT distributed with the plugin.
+ * .mcp.json at project root causes confusion between plugin and project config.
+ */
+describe('No conflicting .mcp.json in repo', () => {
+  it('does NOT have .mcp.json in repo root (prevents config confusion)', () => {
+    const mcpJsonPath = join(process.cwd(), '.mcp.json');
+
+    // .mcp.json should NOT exist in the repo
+    // - For plugin mode: use mcpServers in plugin.json
+    // - For development: use ~/.claude.json per README
+    expect(existsSync(mcpJsonPath)).toBe(false);
+  });
+});

package/.mcp.json

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "bluera-knowledge": {
-      "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js"],
-      "env": {
-        "DATA_DIR": ".bluera/bluera-knowledge/data",
-        "CONFIG_PATH": ".bluera/bluera-knowledge/config.json"
-      }
-    }
-  }
-}