bluera-knowledge 0.11.20 → 0.11.21

package/.claude-plugin/plugin.json

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

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.11.21](https://github.com/blueraai/bluera-knowledge/compare/v0.11.20...v0.11.21) (2026-01-10)
+
+
+### Features
+
+* **cli:** add --branch option to store create command ([8b3209f](https://github.com/blueraai/bluera-knowledge/commit/8b3209f34e22f78df54fc6a64cf1d8b91833dabc))
+* **mcp:** add mode and threshold params to search tool ([18acdb5](https://github.com/blueraai/bluera-knowledge/commit/18acdb590944b9e1ebf1851d0eab32f746ac1758))
+* **sync:** add --reindex flag to sync command ([1344d98](https://github.com/blueraai/bluera-knowledge/commit/1344d984fdc5a75b25687d55ad186416d14203a9))
+
+
+### Bug Fixes
+
+* **code-graph:** preserve confidence in serialized edges ([d88c342](https://github.com/blueraai/bluera-knowledge/commit/d88c342e4225f984db02691437ab1c54d29ad07d))
+* **job-service:** throw on missing HOME/USERPROFILE env vars ([b0a79fb](https://github.com/blueraai/bluera-knowledge/commit/b0a79fbe996c5e4e333ce4ad7a338cdda4af2d70))
+* **store:** clean up all resources on store deletion ([fbcff02](https://github.com/blueraai/bluera-knowledge/commit/fbcff02f304e8b330c1656db32f6b237a63f3295))
+
 ## [0.11.20](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.20) (2026-01-10)
 
 

package/README.md

@@ -1248,9 +1248,12 @@ The plugin exposes 3 MCP tools optimized for minimal context overhead:
 **Parameters:**
 - `query` - Search query (natural language, patterns, or type signatures)
 - `intent` - Search intent: find-pattern, find-implementation, find-usage, find-definition, find-documentation
+- `mode` - Search mode: hybrid (default), vector, or fts
 - `detail` - Context level: minimal, contextual, or full
 - `limit` - Maximum results (default: 10)
 - `stores` - Array of specific store IDs to search (optional, searches all stores if not specified)
+- `threshold` - Minimum normalized score (0-1) for filtering results
+- `minRelevance` - Minimum raw cosine similarity (0-1) for filtering results
 
 #### `get_full_context`
 📖 Retrieve complete code and context for a specific search result by ID.
@@ -1311,6 +1314,9 @@ npm install --save-dev bluera-knowledge
 # Add a Git repository
 bluera-knowledge store create react --type repo --source https://github.com/facebook/react
 
+# Add a Git repository with specific branch
+bluera-knowledge store create react-canary --type repo --source https://github.com/facebook/react --branch canary
+
 # Add a local folder
 bluera-knowledge store create my-docs --type file --source ./docs
 
@@ -1318,12 +1324,33 @@ bluera-knowledge store create my-docs --type file --source ./docs
 bluera-knowledge store create fastapi-docs --type web --source https://fastapi.tiangolo.com
 ```
 
+**Create Options:**
+- `-t, --type <type>` - Store type: `file`, `repo`, or `web` (required)
+- `-s, --source <path>` - Local path or URL (required)
+- `-b, --branch <branch>` - Git branch to clone (repo stores only)
+- `-d, --description <desc>` - Optional store description
+- `--tags <tags>` - Comma-separated tags for filtering
+
 #### Index a Store
 
 ```bash
+# Re-index a store (only changed files)
 bluera-knowledge index react
+
+# Force re-index all files (ignores cache)
+bluera-knowledge index react --force
+
+# Watch for changes and auto-reindex
+bluera-knowledge index watch react
+bluera-knowledge index watch react --debounce 2000  # Custom debounce (default: 1000ms)
 ```
 
+**Index Options:**
+- `-f, --force` - Re-index all files (ignore incremental cache)
+
+**Watch Options:**
+- `--debounce <ms>` - Debounce delay for file changes (default: 1000ms)
+
 #### Search
 
 ```bash
@@ -1368,17 +1395,27 @@ bluera-knowledge store info react
 #### Delete a Store
 
 ```bash
+# Interactive deletion (prompts for confirmation in TTY mode)
 bluera-knowledge store delete old-store
+
+# Force delete without confirmation
+bluera-knowledge store delete old-store --force
+bluera-knowledge store delete old-store -y
 ```
 
+**Delete Options:**
+- `-f, --force` - Delete without confirmation prompt
+- `-y, --yes` - Alias for `--force`
+
 ### Global Options
 
 ```bash
---config <path>      # Custom config file
---data-dir <path>    # Custom data directory
---format <format>    # Output format: json | table | plain
---quiet              # Suppress non-essential output
---verbose            # Enable verbose logging
+--config <path>        # Custom config file
+--data-dir <path>      # Custom data directory
+--project-root <path>  # Project root for store definitions (required for sync)
+--format <format>      # Output format: json | table | plain
+--quiet                # Suppress non-essential output
+--verbose              # Enable verbose logging
 ```
 
 ### When to Use CLI vs Plugin

package/commands/crawl.md

@@ -1,6 +1,6 @@
 ---
 description: Crawl web pages with natural language control and add to knowledge store
-argument-hint: "[url] [store-name] [--crawl instruction] [--extract instruction]"
+argument-hint: "[url] [store-name] [--crawl instruction] [--extract instruction] [--fast]"
 allowed-tools: [Bash(*)]
 ---
 
@@ -36,9 +36,9 @@ The web pages will be crawled with intelligent link selection and optional natur
 /bluera-knowledge:crawl https://example.com/docs docs-store --simple
 ```
 
-**Headless browser for JavaScript-rendered sites:**
+**Fast mode (axios-only, no JavaScript rendering):**
 ```
-/bluera-knowledge:crawl https://code.claude.com/docs claude-docs --headless --max-pages 20
+/bluera-knowledge:crawl https://example.com/docs docs-store --fast --max-pages 20
 ```
 
 ## Options
@@ -47,7 +47,7 @@ The web pages will be crawled with intelligent link selection and optional natur
 - `--extract <instruction>` - Natural language instruction for what content to extract (e.g., "extract API references")
 - `--simple` - Use simple BFS (breadth-first search) mode instead of intelligent crawling
 - `--max-pages <number>` - Maximum number of pages to crawl (default: 50)
-- `--headless` - Use headless browser (Playwright via crawl4ai) for JavaScript-rendered sites
-  - Required for modern frameworks (Next.js, React, Vue, etc.) that render content via client-side JavaScript
-  - Slower than default (axios) but handles client-side rendering
-  - Falls back to axios if headless fetch fails
+- `--fast` - Use fast axios-only mode instead of headless browser
+  - Default behavior uses headless browser (Playwright via crawl4ai) for JavaScript-rendered sites
+  - Use `--fast` when the target site doesn't use client-side rendering
+  - Much faster than headless mode but may miss content from JavaScript-heavy sites

package/commands/search.md

@@ -1,6 +1,6 @@
 ---
 description: Search indexed library sources
-argument-hint: "[query] [--stores names] [--limit N]"
+argument-hint: "[query] [--stores names] [--limit N] [--mode vector|fts|hybrid] [--detail minimal|contextual|full] [--threshold 0-1] [--min-relevance 0-1]"
 allowed-tools: ["mcp__bluera-knowledge__search"]
 ---
 
@@ -14,12 +14,19 @@ Search indexed library sources for: **$ARGUMENTS**
    - Extract the search query (required)
    - Extract --stores parameter (optional, comma-separated store names)
    - Extract --limit parameter (optional, default 10)
+   - Extract --mode parameter (optional: vector, fts, hybrid; default hybrid)
+   - Extract --detail parameter (optional: minimal, contextual, full; default contextual)
+   - Extract --threshold parameter (optional, 0-1 range for normalized score filtering)
+   - Extract --min-relevance parameter (optional, 0-1 range for raw cosine similarity filtering)
 
 2. Call mcp__bluera-knowledge__search with:
    - query: The search query string
    - stores: Array of store names (if --stores specified)
    - limit: Number of results (if --limit specified, default 10)
-   - detail: "contextual"
+   - mode: Search mode (if --mode specified, default "hybrid")
+   - detail: Detail level (if --detail specified, default "contextual")
+   - threshold: Minimum normalized score (if --threshold specified)
+   - minRelevance: Minimum raw cosine similarity (if --min-relevance specified)
    - intent: "find-implementation"
 
 3. Format and display results with rich context:

package/dist/{chunk-MQGRQ2EG.js → chunk-C4SYGLAI.js}

@@ -262,10 +262,16 @@ function err(error) {
 var JobService = class {
   jobsDir;
   constructor(dataDir) {
-    const baseDir = dataDir ?? path.join(
-      process.env["HOME"] ?? process.env["USERPROFILE"] ?? ".",
-      ".local/share/bluera-knowledge"
-    );
+    let baseDir;
+    if (dataDir !== void 0) {
+      baseDir = dataDir;
+    } else {
+      const homeDir = process.env["HOME"] ?? process.env["USERPROFILE"];
+      if (homeDir === void 0) {
+        throw new Error("HOME or USERPROFILE environment variable is required");
+      }
+      baseDir = path.join(homeDir, ".local/share/bluera-knowledge");
+    }
     this.jobsDir = path.join(baseDir, "jobs");
     if (!fs.existsSync(this.jobsDir)) {
       fs.mkdirSync(this.jobsDir, { recursive: true });
@@ -451,7 +457,7 @@ var JobService = class {
 };
 
 // src/services/code-graph.service.ts
-import { readFile, writeFile, mkdir } from "fs/promises";
+import { readFile, writeFile, mkdir, rm } from "fs/promises";
 import { join as join3, dirname } from "path";
 
 // src/analysis/ast-parser.ts
@@ -763,7 +769,12 @@ var CodeGraph = class {
     }
     return {
       nodes: Array.from(this.nodes.values()),
-      edges: allEdges.map((e) => ({ from: e.from, to: e.to, type: e.type }))
+      edges: allEdges.map((e) => ({
+        from: e.from,
+        to: e.to,
+        type: e.type,
+        confidence: e.confidence
+      }))
     };
   }
 };
@@ -1668,6 +1679,15 @@ var CodeGraphService = class {
     const serialized = graph.toJSON();
     await writeFile(graphPath, JSON.stringify(serialized, null, 2));
   }
+  /**
+   * Delete the code graph file for a store.
+   * Silently succeeds if the file doesn't exist.
+   */
+  async deleteGraph(storeId) {
+    const graphPath = this.getGraphPath(storeId);
+    await rm(graphPath, { force: true });
+    this.graphCache.delete(storeId);
+  }
   /**
    * Load a code graph for a store.
    * Returns undefined if no graph exists.
@@ -4518,4 +4538,4 @@ export {
   createServices,
   destroyServices
 };
-//# sourceMappingURL=chunk-MQGRQ2EG.js.map
+//# sourceMappingURL=chunk-C4SYGLAI.js.map