bluera-knowledge 0.33.2 → 0.34.1

package/dist/index.js

@@ -3,11 +3,11 @@ import {
   ZilAdapter,
   runMCPServer,
   spawnBackgroundWorker
-} from "./chunk-OPLZTNKK.js";
+} from "./chunk-V5MWZM5X.js";
 import {
   IntelligentCrawler,
   getCrawlStrategy
-} from "./chunk-OMXQBWCR.js";
+} from "./chunk-TD3VX74F.js";
 import {
   ASTParser,
   AdapterRegistry,
@@ -25,7 +25,7 @@ import {
   isRepoStoreDefinition,
   isWebStoreDefinition,
   ok
-} from "./chunk-SROFPHRA.js";
+} from "./chunk-VELBEZVB.js";
 import {
   createDocumentId
 } from "./chunk-CLIMKLTW.js";

package/dist/mcp/bootstrap.js

@@ -14,7 +14,11 @@ import {
 import { homedir } from "os";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
-var envProjectRoot = process.env["PROJECT_ROOT"];
+function expandShellVars(value) {
+  return value.replace(/\$\{(\w+)\}/g, (match, name) => process.env[name] ?? match);
+}
+var rawProjectRoot = process.env["PROJECT_ROOT"];
+var envProjectRoot = rawProjectRoot !== void 0 && rawProjectRoot !== "" ? expandShellVars(rawProjectRoot) : void 0;
 var logDir = envProjectRoot !== void 0 && envProjectRoot !== "" ? join(envProjectRoot, ".bluera", "bluera-knowledge", "logs") : join(homedir(), ".bluera", "bluera-knowledge", "logs");
 var logFile = join(logDir, "app.log");
 var log = (level, msg, data) => {
@@ -147,7 +151,7 @@ log("info", "Loading server module");
 var importStart = Date.now();
 var { runMCPServer } = await import("./server.js");
 log("debug", "Server module loaded", { elapsedMs: Date.now() - importStart });
-var projectRoot = process.env["PROJECT_ROOT"];
+var projectRoot = process.env["PROJECT_ROOT"] !== void 0 ? expandShellVars(process.env["PROJECT_ROOT"]) : void 0;
 if (projectRoot === void 0) {
   throw new Error("PROJECT_ROOT environment variable is required");
 }

package/dist/mcp/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/bootstrap.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * MCP Server Bootstrap - installs dependencies before starting server.\n *\n * Uses only Node.js built-ins (no external dependencies required).\n * Self-locates plugin root via import.meta.url (doesn't rely on CLAUDE_PLUGIN_ROOT).\n *\n * Dependency installation strategy:\n * 1. Fast path: node_modules already exists → skip\n * 2. Package manager: Run bun install or npm install\n *\n * IMPORTANT: MCP servers must NOT log to stderr - Claude Code treats stderr output\n * as an error and may mark the MCP server as failed. All logging goes to file.\n */\nimport { execSync } from 'node:child_process';\nimport {\n  appendFileSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n// Logging helper - writes to file since MCP servers must NOT use stderr\n// (Claude Code treats stderr as error and may fail the server)\n// JSON format matches pino output for consistency\n// Use PROJECT_ROOT if available (set by Claude Code), else fall back to home dir\nconst envProjectRoot = process.env['PROJECT_ROOT'];\nconst logDir =\n  envProjectRoot !== undefined && envProjectRoot !== ''\n    ? join(envProjectRoot, '.bluera', 'bluera-knowledge', 'logs')\n    : join(homedir(), '.bluera', 'bluera-knowledge', 'logs');\nconst logFile = join(logDir, 'app.log');\n\nconst log = (\n  level: 'info' | 'error' | 'debug',\n  msg: string,\n  data?: Record<string, unknown>\n): void => {\n  try {\n    mkdirSync(logDir, { recursive: true });\n    const entry = {\n      time: new Date().toISOString(),\n      level,\n      module: 'bootstrap',\n      msg,\n      ...data,\n    };\n    appendFileSync(logFile, `${JSON.stringify(entry)}\\n`);\n  } catch {\n    // Silently fail - we cannot use stderr for MCP servers\n  }\n};\n\n// Self-locate plugin root from this file's path\n// dist/mcp/bootstrap.js -> plugin root (two directories up)\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst pluginRoot = join(__dirname, '..', '..');\n\n// Lock file to detect interrupted installs\nconst installLockFile = join(pluginRoot, '.node_modules_installing');\n\n// Get version from package.json for logging\nconst getVersion = (): string => {\n  try {\n    const pkg: unknown = JSON.parse(readFileSync(join(pluginRoot, 'package.json'), 'utf-8'));\n    if (\n      typeof pkg === 'object' &&\n      pkg !== null &&\n      'version' in pkg &&\n      typeof pkg.version === 'string'\n    ) {\n      return `v${pkg.version}`;\n    }\n    return 'unknown';\n  } catch {\n    return 'unknown';\n  }\n};\n\n/**\n * Check if build tools are available for native module compilation.\n * Logs error to file and throws if make is not found.\n */\nfunction checkBuildTools(): void {\n  try {\n    execSync('which make', { stdio: 'ignore' });\n    log('debug', 'Build tools available (make found)');\n  } catch {\n    log('error', 'Build tools not found - make is required for native modules', {\n      fix: 'Install build-essential (Debian/Ubuntu), Development Tools (Fedora), or Xcode CLI Tools (macOS)',\n    });\n    throw new Error(\n      'Build tools not found. Install: sudo apt install build-essential (Debian/Ubuntu), ' +\n        'sudo dnf groupinstall \"Development Tools\" (Fedora), or xcode-select --install (macOS)'\n    );\n  }\n}\n\n/**\n * Install dependencies using bun or npm.\n * Uses stdio: 'pipe' to capture output and avoid corrupting MCP stdio transport.\n */\nfunction installWithPackageManager(): void {\n  const hasBun = ((): boolean => {\n    try {\n      execSync('which bun', { stdio: 'ignore' });\n      return true;\n    } catch {\n      return false;\n    }\n  })();\n\n  // CRITICAL: npm needs peer-deps bypass flag (tree-sitter-go/rust have conflicting requirements)\n  const cmd = hasBun ? 'bun install --frozen-lockfile' : 'npm install --legacy-peer-deps --silent';\n  log('info', 'Installing dependencies with package manager', { hasBun, cmd });\n\n  try {\n    // Use stdio: 'pipe' to capture output - 'inherit' would corrupt MCP stdio transport\n    // Skip browser downloads during install - browsers are installed separately by setup.sh\n    const output = execSync(cmd, {\n      cwd: pluginRoot,\n      stdio: 'pipe',\n      env: {\n        ...process.env,\n        PUPPETEER_SKIP_DOWNLOAD: '1',\n        PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1',\n      },\n    });\n    if (output.length > 0) {\n      log('debug', 'Install output', { output: output.toString().trim() });\n    }\n    log('info', 'Dependencies installed via package manager');\n  } catch (error) {\n    // Log installation failure details before re-throwing\n    // execSync throws an object with stdout/stderr buffers on failure\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorDetails: Record<string, unknown> = { message: errorMessage };\n\n    if (typeof error === 'object' && error !== null) {\n      if ('stdout' in error && Buffer.isBuffer(error.stdout)) {\n        errorDetails['stdout'] = error.stdout.toString().trim();\n      }\n      if ('stderr' in error && Buffer.isBuffer(error.stderr)) {\n        errorDetails['stderr'] = error.stderr.toString().trim();\n      }\n    }\n\n    log('error', 'Dependency installation failed', errorDetails);\n    throw error;\n  }\n}\n\n/**\n * Ensure dependencies are available.\n * Uses a lock file to detect and recover from interrupted installs.\n */\nfunction ensureDependencies(): void {\n  const startTime = Date.now();\n  log('debug', 'ensureDependencies starting');\n\n  const nodeModulesPath = join(pluginRoot, 'node_modules');\n\n  // Check for interrupted install - lock file exists means previous install was killed\n  log('debug', 'Checking for interrupted install lock file', { lockFile: installLockFile });\n  if (existsSync(installLockFile)) {\n    log('info', 'Detected interrupted install, cleaning up');\n    rmSync(nodeModulesPath, { recursive: true, force: true });\n    unlinkSync(installLockFile);\n    log('debug', 'Cleanup complete');\n  }\n\n  // Fast path: already installed\n  log('debug', 'Checking node_modules exists', { path: nodeModulesPath });\n  if (existsSync(nodeModulesPath)) {\n    log('info', 'Dependencies already installed', { elapsedMs: Date.now() - startTime });\n    return;\n  }\n\n  // Verify package.json exists before attempting install\n  const packageJsonPath = join(pluginRoot, 'package.json');\n  if (!existsSync(packageJsonPath)) {\n    log('error', 'package.json not found in plugin root — plugin cache may be corrupt', {\n      pluginRoot,\n      fix: 'Reinstall: /plugin uninstall bluera-knowledge && /plugin install bluera-knowledge@bluera',\n    });\n    throw new Error(\n      `package.json not found at ${pluginRoot}. ` +\n        'Plugin cache may be corrupt. ' +\n        'Fix: /plugin uninstall bluera-knowledge && /plugin install bluera-knowledge@bluera'\n    );\n  }\n\n  // Check build tools before attempting install\n  log('debug', 'Checking build tools before install');\n  checkBuildTools();\n\n  // Create lock file before install (left behind if install interrupted/fails)\n  log('debug', 'Creating lock file before install');\n  writeFileSync(installLockFile, new Date().toISOString());\n\n  const installStart = Date.now();\n  log('debug', 'Starting package manager install');\n  installWithPackageManager();\n  log('debug', 'Package manager install finished', { elapsedMs: Date.now() - installStart });\n\n  // Remove lock file on success\n  unlinkSync(installLockFile);\n  log('debug', 'ensureDependencies complete', { totalElapsedMs: Date.now() - startTime });\n}\n\n// Main entry point\nconst bootstrapStartTime = Date.now();\nconst VERSION = getVersion();\nlog('info', 'Bootstrap starting', { pluginRoot, version: VERSION });\n\nlog('debug', 'Calling ensureDependencies');\nensureDependencies();\nlog('debug', 'ensureDependencies returned', { elapsedMs: Date.now() - bootstrapStartTime });\n\n// Now that dependencies are installed, import and run the server\n// Dynamic import required because @modelcontextprotocol/sdk wouldn't be available before install\nlog('info', 'Loading server module');\nconst importStart = Date.now();\nconst { runMCPServer } = await import('./server.js');\nlog('debug', 'Server module loaded', { elapsedMs: Date.now() - importStart });\n\nconst projectRoot = process.env['PROJECT_ROOT'];\nif (projectRoot === undefined) {\n  throw new Error('PROJECT_ROOT environment variable is required');\n}\n\nlog('info', 'Starting MCP server', {\n  projectRoot,\n  dataDir: process.env['DATA_DIR'],\n});\n\nawait runMCPServer({\n  dataDir: process.env['DATA_DIR'],\n  config: process.env['CONFIG_PATH'],\n  projectRoot,\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/mcp/bootstrap.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * MCP Server Bootstrap - installs dependencies before starting server.\n *\n * Uses only Node.js built-ins (no external dependencies required).\n * Self-locates plugin root via import.meta.url (doesn't rely on CLAUDE_PLUGIN_ROOT).\n *\n * Dependency installation strategy:\n * 1. Fast path: node_modules already exists → skip\n * 2. Package manager: Run bun install or npm install\n *\n * IMPORTANT: MCP servers must NOT log to stderr - Claude Code treats stderr output\n * as an error and may mark the MCP server as failed. All logging goes to file.\n */\nimport { execSync } from 'node:child_process';\nimport {\n  appendFileSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n// Expand shell variable references like ${PWD} that Claude Code doesn't expand\n// when passing env vars from .mcp.json to the MCP server process.\nfunction expandShellVars(value: string): string {\n  return value.replace(/\\$\\{(\\w+)\\}/g, (match, name: string) => process.env[name] ?? match);\n}\n\n// Logging helper - writes to file since MCP servers must NOT use stderr\n// (Claude Code treats stderr as error and may fail the server)\n// JSON format matches pino output for consistency\n// Use PROJECT_ROOT if available (set by Claude Code), else fall back to home dir\nconst rawProjectRoot = process.env['PROJECT_ROOT'];\nconst envProjectRoot =\n  rawProjectRoot !== undefined && rawProjectRoot !== ''\n    ? expandShellVars(rawProjectRoot)\n    : undefined;\nconst logDir =\n  envProjectRoot !== undefined && envProjectRoot !== ''\n    ? join(envProjectRoot, '.bluera', 'bluera-knowledge', 'logs')\n    : join(homedir(), '.bluera', 'bluera-knowledge', 'logs');\nconst logFile = join(logDir, 'app.log');\n\nconst log = (\n  level: 'info' | 'error' | 'debug',\n  msg: string,\n  data?: Record<string, unknown>\n): void => {\n  try {\n    mkdirSync(logDir, { recursive: true });\n    const entry = {\n      time: new Date().toISOString(),\n      level,\n      module: 'bootstrap',\n      msg,\n      ...data,\n    };\n    appendFileSync(logFile, `${JSON.stringify(entry)}\\n`);\n  } catch {\n    // Silently fail - we cannot use stderr for MCP servers\n  }\n};\n\n// Self-locate plugin root from this file's path\n// dist/mcp/bootstrap.js -> plugin root (two directories up)\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst pluginRoot = join(__dirname, '..', '..');\n\n// Lock file to detect interrupted installs\nconst installLockFile = join(pluginRoot, '.node_modules_installing');\n\n// Get version from package.json for logging\nconst getVersion = (): string => {\n  try {\n    const pkg: unknown = JSON.parse(readFileSync(join(pluginRoot, 'package.json'), 'utf-8'));\n    if (\n      typeof pkg === 'object' &&\n      pkg !== null &&\n      'version' in pkg &&\n      typeof pkg.version === 'string'\n    ) {\n      return `v${pkg.version}`;\n    }\n    return 'unknown';\n  } catch {\n    return 'unknown';\n  }\n};\n\n/**\n * Check if build tools are available for native module compilation.\n * Logs error to file and throws if make is not found.\n */\nfunction checkBuildTools(): void {\n  try {\n    execSync('which make', { stdio: 'ignore' });\n    log('debug', 'Build tools available (make found)');\n  } catch {\n    log('error', 'Build tools not found - make is required for native modules', {\n      fix: 'Install build-essential (Debian/Ubuntu), Development Tools (Fedora), or Xcode CLI Tools (macOS)',\n    });\n    throw new Error(\n      'Build tools not found. Install: sudo apt install build-essential (Debian/Ubuntu), ' +\n        'sudo dnf groupinstall \"Development Tools\" (Fedora), or xcode-select --install (macOS)'\n    );\n  }\n}\n\n/**\n * Install dependencies using bun or npm.\n * Uses stdio: 'pipe' to capture output and avoid corrupting MCP stdio transport.\n */\nfunction installWithPackageManager(): void {\n  const hasBun = ((): boolean => {\n    try {\n      execSync('which bun', { stdio: 'ignore' });\n      return true;\n    } catch {\n      return false;\n    }\n  })();\n\n  // CRITICAL: npm needs peer-deps bypass flag (tree-sitter-go/rust have conflicting requirements)\n  const cmd = hasBun ? 'bun install --frozen-lockfile' : 'npm install --legacy-peer-deps --silent';\n  log('info', 'Installing dependencies with package manager', { hasBun, cmd });\n\n  try {\n    // Use stdio: 'pipe' to capture output - 'inherit' would corrupt MCP stdio transport\n    // Skip browser downloads during install - browsers are installed separately by setup.sh\n    const output = execSync(cmd, {\n      cwd: pluginRoot,\n      stdio: 'pipe',\n      env: {\n        ...process.env,\n        PUPPETEER_SKIP_DOWNLOAD: '1',\n        PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1',\n      },\n    });\n    if (output.length > 0) {\n      log('debug', 'Install output', { output: output.toString().trim() });\n    }\n    log('info', 'Dependencies installed via package manager');\n  } catch (error) {\n    // Log installation failure details before re-throwing\n    // execSync throws an object with stdout/stderr buffers on failure\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorDetails: Record<string, unknown> = { message: errorMessage };\n\n    if (typeof error === 'object' && error !== null) {\n      if ('stdout' in error && Buffer.isBuffer(error.stdout)) {\n        errorDetails['stdout'] = error.stdout.toString().trim();\n      }\n      if ('stderr' in error && Buffer.isBuffer(error.stderr)) {\n        errorDetails['stderr'] = error.stderr.toString().trim();\n      }\n    }\n\n    log('error', 'Dependency installation failed', errorDetails);\n    throw error;\n  }\n}\n\n/**\n * Ensure dependencies are available.\n * Uses a lock file to detect and recover from interrupted installs.\n */\nfunction ensureDependencies(): void {\n  const startTime = Date.now();\n  log('debug', 'ensureDependencies starting');\n\n  const nodeModulesPath = join(pluginRoot, 'node_modules');\n\n  // Check for interrupted install - lock file exists means previous install was killed\n  log('debug', 'Checking for interrupted install lock file', { lockFile: installLockFile });\n  if (existsSync(installLockFile)) {\n    log('info', 'Detected interrupted install, cleaning up');\n    rmSync(nodeModulesPath, { recursive: true, force: true });\n    unlinkSync(installLockFile);\n    log('debug', 'Cleanup complete');\n  }\n\n  // Fast path: already installed\n  log('debug', 'Checking node_modules exists', { path: nodeModulesPath });\n  if (existsSync(nodeModulesPath)) {\n    log('info', 'Dependencies already installed', { elapsedMs: Date.now() - startTime });\n    return;\n  }\n\n  // Verify package.json exists before attempting install\n  const packageJsonPath = join(pluginRoot, 'package.json');\n  if (!existsSync(packageJsonPath)) {\n    log('error', 'package.json not found in plugin root — plugin cache may be corrupt', {\n      pluginRoot,\n      fix: 'Reinstall: /plugin uninstall bluera-knowledge && /plugin install bluera-knowledge@bluera',\n    });\n    throw new Error(\n      `package.json not found at ${pluginRoot}. ` +\n        'Plugin cache may be corrupt. ' +\n        'Fix: /plugin uninstall bluera-knowledge && /plugin install bluera-knowledge@bluera'\n    );\n  }\n\n  // Check build tools before attempting install\n  log('debug', 'Checking build tools before install');\n  checkBuildTools();\n\n  // Create lock file before install (left behind if install interrupted/fails)\n  log('debug', 'Creating lock file before install');\n  writeFileSync(installLockFile, new Date().toISOString());\n\n  const installStart = Date.now();\n  log('debug', 'Starting package manager install');\n  installWithPackageManager();\n  log('debug', 'Package manager install finished', { elapsedMs: Date.now() - installStart });\n\n  // Remove lock file on success\n  unlinkSync(installLockFile);\n  log('debug', 'ensureDependencies complete', { totalElapsedMs: Date.now() - startTime });\n}\n\n// Main entry point\nconst bootstrapStartTime = Date.now();\nconst VERSION = getVersion();\nlog('info', 'Bootstrap starting', { pluginRoot, version: VERSION });\n\nlog('debug', 'Calling ensureDependencies');\nensureDependencies();\nlog('debug', 'ensureDependencies returned', { elapsedMs: Date.now() - bootstrapStartTime });\n\n// Now that dependencies are installed, import and run the server\n// Dynamic import required because @modelcontextprotocol/sdk wouldn't be available before install\nlog('info', 'Loading server module');\nconst importStart = Date.now();\nconst { runMCPServer } = await import('./server.js');\nlog('debug', 'Server module loaded', { elapsedMs: Date.now() - importStart });\n\nconst projectRoot =\n  process.env['PROJECT_ROOT'] !== undefined\n    ? expandShellVars(process.env['PROJECT_ROOT'])\n    : undefined;\nif (projectRoot === undefined) {\n  throw new Error('PROJECT_ROOT environment variable is required');\n}\n\nlog('info', 'Starting MCP server', {\n  projectRoot,\n  dataDir: process.env['DATA_DIR'],\n});\n\nawait runMCPServer({\n  dataDir: process.env['DATA_DIR'],\n  config: process.env['CONFIG_PATH'],\n  projectRoot,\n});\n"],"mappings":"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","names":[]}

package/dist/mcp/server.js

@@ -1,8 +1,8 @@
 import {
   createMCPServer,
   runMCPServer
-} from "../chunk-OPLZTNKK.js";
-import "../chunk-SROFPHRA.js";
+} from "../chunk-V5MWZM5X.js";
+import "../chunk-VELBEZVB.js";
 import "../chunk-CLIMKLTW.js";
 import "../chunk-N3XYMAU3.js";
 import "../chunk-DGUM43GV.js";

package/dist/workers/background-worker-cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   IntelligentCrawler
-} from "../chunk-OMXQBWCR.js";
+} from "../chunk-TD3VX74F.js";
 import {
   JobService,
   createLogger,
   createServices,
   destroyServices,
   shutdownLogger
-} from "../chunk-SROFPHRA.js";
+} from "../chunk-VELBEZVB.js";
 import {
   createDocumentId,
   createStoreId

package/hooks/hooks.json

@@ -22,18 +22,6 @@
         ]
       }
     ],
-    "PreToolUse": [
-      {
-        "matcher": "Grep|Read",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT:-.}/hooks/pretooluse-bk-suggest.py",
-            "timeout": 2
-          }
-        ]
-      }
-    ],
     "PostToolUse": [
       {
         "matcher": "Grep",
@@ -74,16 +62,6 @@
             "timeout": 2
           }
         ]
-      },
-      {
-        "matcher": "mcp__.*bluera-knowledge__search",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo 'TIP: Use mcp__bluera-knowledge__get_full_context with the result ID for complete code context.'",
-            "timeout": 1
-          }
-        ]
       }
     ],
     "UserPromptSubmit": [
@@ -94,11 +72,6 @@
             "command": "${CLAUDE_PLUGIN_ROOT:-.}/hooks/job-status-hook.sh",
             "timeout": 2,
             "async": true
-          },
-          {
-            "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT:-.}/hooks/skill-activation.py",
-            "timeout": 2
           }
         ]
       }

package/package.json

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

package/skills/knowledge-search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: knowledge-search
-description: Query BK for library internals via vector search or direct Grep/Read
+description: Use when the user asks about libraries, frameworks, dependencies, API references, implementation details, or needs code examples from third-party packages. Activates for library API questions, dependency errors, framework configuration, or code generation involving external packages.
 ---
 
 # Using Bluera Knowledge (BK)