bluera-knowledge 0.34.2 → 0.36.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.34.2",
+  "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,35 @@
 
 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)
+
+
+### Features
+
+* **mcp:** return friendly message when add-repo URL is already indexed ([0d03932](https://github.com/blueraai/bluera-knowledge/commit/0d0393213a50389331b109d8676ef2c53b2561a0))
+
+
+### Bug Fixes
+
+* **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.34.2](https://github.com/blueraai/bluera-knowledge/compare/v0.34.0...v0.34.2) (2026-03-19)
 
 

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/{chunk-V5MWZM5X.js → chunk-DNGE7FZ4.js}

@@ -12,7 +12,7 @@ import {
   isWebStoreDefinition,
   ok,
   summarizePayload
-} from "./chunk-VELBEZVB.js";
+} from "./chunk-L2SC6J4K.js";
 import {
   DEFAULT_IGNORE_DIRS,
   checkStoreModelCompatibility
@@ -1338,6 +1338,9 @@ var handleGetStoreInfo = async (args, context) => {
     ]
   };
 };
+function normalizeRepoUrl(url) {
+  return url.replace(/\.git$/, "").replace(/\/$/, "").toLowerCase();
+}
 var handleCreateStore = async (args, context) => {
   const validated = CreateStoreArgsSchema.parse(args);
   logger6.info(
@@ -1346,6 +1349,54 @@ var handleCreateStore = async (args, context) => {
   );
   const { services, options } = context;
   const isUrl = validated.source.startsWith("http://") || validated.source.startsWith("https://") || validated.source.startsWith("git@");
+  if (isUrl) {
+    const stores = await services.store.list();
+    const normalizedSource = normalizeRepoUrl(validated.source);
+    const existing = stores.find(
+      (s) => "url" in s && s.url !== void 0 && normalizeRepoUrl(s.url) === normalizedSource
+    );
+    if (existing !== void 0) {
+      const storePath2 = "path" in existing ? existing.path : void 0;
+      logger6.info(
+        { name: validated.name, existingName: existing.name, url: validated.source },
+        "Duplicate URL detected \u2014 returning existing store info"
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                alreadyIndexed: true,
+                store: {
+                  id: existing.id,
+                  name: existing.name,
+                  type: existing.type,
+                  path: storePath2,
+                  url: "url" in existing ? existing.url : void 0,
+                  createdAt: existing.createdAt.toISOString(),
+                  updatedAt: existing.updatedAt.toISOString()
+                },
+                search: {
+                  tool: "search",
+                  example: { query: "your question here", stores: [existing.name] },
+                  tip: storePath2 !== void 0 ? `Files also available for Grep/Read at: ${storePath2}` : void 0
+                },
+                actions: {
+                  reindex: `Use store:index ${existing.name} to re-index with current embeddings`,
+                  pull: `Use stores:pull ${existing.name} to git pull latest and re-index`,
+                  recreate: `Use store:delete ${existing.name} first, then store:create again for a fresh clone`
+                },
+                message: `Repository already indexed as '${existing.name}' (last updated ${existing.updatedAt.toISOString()}). Use search tool with stores: ["${existing.name}"] to query it.`
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  }
   const result = await services.store.create({
     name: validated.name,
     type: validated.type,
@@ -2830,4 +2881,4 @@ export {
   createMCPServer,
   runMCPServer
 };
-//# sourceMappingURL=chunk-V5MWZM5X.js.map
+//# sourceMappingURL=chunk-DNGE7FZ4.js.map