bluera-knowledge 0.35.0 → 0.36.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.35.0",
+  "version": "0.36.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,22 @@
 
 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.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
@@ -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/dist/index.js

@@ -16,6 +16,7 @@ import {
   ProjectRootService,
   StoreDefinitionService,
   classifyWebContentType,
+  createLogger,
   createServices,
   destroyServices,
   err,
@@ -421,6 +422,7 @@ function createMCPCommand(getOptions) {
 import { Command as Command4 } from "commander";
 
 // src/plugin/commands.ts
+import { execSync } from "child_process";
 import ora3 from "ora";
 
 // src/analysis/dependency-usage-analyzer.ts
@@ -894,6 +896,14 @@ var RepoUrlResolver = class {
 };
 
 // src/plugin/commands.ts
+var logger = createLogger("plugin-commands");
+function extractStringField(obj, key) {
+  if (typeof obj !== "object" || obj === null || !(key in obj)) return void 0;
+  const descriptor = Object.getOwnPropertyDescriptor(obj, key);
+  if (descriptor === void 0) return void 0;
+  const value = descriptor.value;
+  return typeof value === "string" ? value : void 0;
+}
 async function handleAddRepo(args, options = {}) {
   const services = await createServices(
     options.config,
@@ -1001,6 +1011,51 @@ async function handleStores(options = {}) {
     await destroyServices(services);
   }
 }
+function filterImportantDeps(usages) {
+  if (usages.length <= 5) return usages;
+  const depList = usages.map(
+    (u) => `- ${u.packageName}: ${String(u.importCount)} imports in ${String(u.fileCount)} files${u.isDevDependency ? " (dev)" : ""}`
+  ).join("\n");
+  const prompt = [
+    "Given this project's dependencies ranked by import frequency:",
+    "",
+    depList,
+    "",
+    "Select the dependencies that would be MOST VALUABLE to have their source code indexed for an AI coding assistant. Focus on:",
+    "- Core frameworks and libraries the project builds on (not dev tools)",
+    "- Libraries with complex APIs where understanding internals helps",
+    "- Libraries likely to cause debugging issues or have non-obvious behavior",
+    "- Skip: test runners, linters, formatters, build tools, @types packages, trivial utilities",
+    "",
+    'Return ONLY a JSON array of package names, e.g.: ["react", "prisma", "zod"]',
+    "Do not explain. Just the JSON array."
+  ].join("\n");
+  const output = execSync("claude -p --output-format json --model haiku", {
+    input: prompt,
+    encoding: "utf-8",
+    timeout: 3e4,
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+  const parsed = JSON.parse(output);
+  const resultText = extractStringField(parsed, "result");
+  if (resultText === void 0) {
+    throw new Error("Unexpected Claude CLI output format");
+  }
+  const jsonMatch = /\[[\s\S]*\]/.exec(resultText);
+  if (jsonMatch === null) {
+    throw new Error("No JSON array found in Claude response");
+  }
+  const selected = JSON.parse(jsonMatch[0]);
+  if (!Array.isArray(selected)) {
+    throw new Error("Claude response is not an array");
+  }
+  const selectedNames = new Set(selected.filter((s) => typeof s === "string"));
+  const filtered = usages.filter((u) => selectedNames.has(u.packageName));
+  if (filtered.length < 2) {
+    throw new Error("Claude returned too few results");
+  }
+  return filtered;
+}
 async function handleSuggest(options = {}) {
   const projectRoot = options.projectRoot ?? process.env["PWD"] ?? process.cwd();
   console.log("Analyzing project dependencies...\n");
@@ -1035,8 +1090,20 @@ async function handleSuggest(options = {}) {
       console.log("\u2714 All dependencies are already in knowledge stores!");
       return;
     }
-    const topSuggestions = newUsages.slice(0, 5);
-    console.log("Top dependencies by usage in this project:\n");
+    let topSuggestions;
+    try {
+      const spinner2 = ora3("Selecting important dependencies with AI...").start();
+      topSuggestions = filterImportantDeps(newUsages);
+      spinner2.stop();
+      console.log("AI-selected dependencies most valuable for source indexing:\n");
+    } catch (error) {
+      logger.debug(
+        { error: error instanceof Error ? error.message : String(error) },
+        "AI filtering unavailable, falling back to top-5 by usage"
+      );
+      topSuggestions = newUsages.slice(0, 5);
+      console.log("Top dependencies by usage in this project:\n");
+    }
     topSuggestions.forEach((usage, i) => {
       console.log(`${String(i + 1)}. ${usage.packageName}`);
       console.log(