bluera-knowledge 0.28.1 → 0.30.0

package/dist/mcp/bootstrap.js

@@ -72,7 +72,15 @@ function installWithPackageManager() {
   const cmd = hasBun ? "bun install --frozen-lockfile" : "npm install --legacy-peer-deps --silent";
   log("info", "Installing dependencies with package manager", { hasBun, cmd });
   try {
-    const output = execSync(cmd, { cwd: pluginRoot, stdio: "pipe" });
+    const output = execSync(cmd, {
+      cwd: pluginRoot,
+      stdio: "pipe",
+      env: {
+        ...process.env,
+        PUPPETEER_SKIP_DOWNLOAD: "1",
+        PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: "1"
+      }
+    });
     if (output.length > 0) {
       log("debug", "Install output", { output: output.toString().trim() });
     }

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    const output = execSync(cmd, { cwd: pluginRoot, stdio: 'pipe' });\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  // 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// 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  // 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":[]}

package/dist/mcp/server.d.ts

@@ -241,6 +241,7 @@ interface IndexingConfig {
     readonly chunkSize: number;
     readonly chunkOverlap: number;
     readonly ignorePatterns: readonly string[];
+    readonly prependPath: boolean;
     readonly maxFileSizeBytes: number;
 }
 interface SearchConfig {
@@ -256,6 +257,12 @@ interface ServerConfig {
     readonly port: number;
     readonly host: string;
 }
+interface RerankerConfig {
+    readonly enabled: boolean;
+    readonly model: string;
+    readonly topK: number;
+    readonly returnK: number;
+}
 interface AppConfig {
     readonly version: number;
     readonly dataDir: string;
@@ -264,6 +271,7 @@ interface AppConfig {
     readonly search: SearchConfig;
     readonly crawl: CrawlConfig;
     readonly server: ServerConfig;
+    readonly reranker: RerankerConfig;
 }
 
 declare class ConfigService {
@@ -496,6 +504,22 @@ declare class LanceStore {
         score: number;
         metadata: DocumentMetadata;
     }>>;
+    /**
+     * Get all documents from a store (for training data generation).
+     * Returns documents in batches to avoid memory issues with large stores.
+     */
+    getAllDocuments(storeId: StoreId, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Array<{
+        id: DocumentId;
+        content: string;
+        metadata: DocumentMetadata;
+    }>>;
+    /**
+     * Count total documents in a store.
+     */
+    countDocuments(storeId: StoreId): Promise<number>;
     deleteStore(storeId: StoreId): Promise<void>;
     close(): void;
     /**
@@ -508,12 +532,31 @@ declare class LanceStore {
     private getTable;
 }
 
+/**
+ * Optional details for enhanced progress reporting.
+ * All fields are optional - consumers use what they need.
+ */
+interface ProgressDetails {
+    /** Current file being processed (basename) */
+    currentFile?: string;
+    /** Milliseconds elapsed since operation start */
+    elapsedMs?: number;
+    /** Throughput for ETA calculation */
+    filesPerSecond?: number;
+    /** Store-level progress for multi-store operations */
+    storeProgress?: {
+        current: number;
+        total: number;
+        storeName: string;
+    };
+}
 interface ProgressEvent {
     type: 'start' | 'progress' | 'complete' | 'error';
     current: number;
     total: number;
     message: string;
-    details?: Record<string, unknown>;
+    /** Enhanced details - optional, existing consumers can ignore */
+    details?: ProgressDetails;
 }
 type ProgressCallback = (event: ProgressEvent) => void;
 
@@ -702,6 +745,7 @@ interface IndexOptions {
     concurrency?: number;
     manifestService?: ManifestService;
     ignorePatterns?: readonly string[];
+    prependPath?: boolean;
     maxFileSizeBytes?: number;
 }
 interface IncrementalIndexResult extends IndexResult {
@@ -720,6 +764,7 @@ declare class IndexService {
     private readonly concurrency;
     private readonly ignoreDirs;
     private readonly ignoreFilePatterns;
+    private readonly prependPath;
     private readonly maxFileSizeBytes;
     constructor(lanceStore: LanceStore, embeddingEngine: EmbeddingEngine, options?: IndexOptions);
     indexStore(store: Store, onProgress?: ProgressCallback): Promise<Result<IndexResult>>;
@@ -767,6 +812,71 @@ declare class IndexService {
     private isInternalImplementation;
 }
 
+interface RerankerCandidate {
+    readonly id: string;
+    readonly content: string;
+    readonly score: number;
+}
+interface RerankerResult {
+    readonly id: string;
+    readonly originalScore: number;
+    readonly rerankerScore: number;
+}
+interface RerankerOutput {
+    readonly results: readonly RerankerResult[];
+    readonly timeMs: number;
+}
+declare class RerankerService {
+    private model;
+    private tokenizer;
+    private initPromise;
+    private disposed;
+    private readonly config;
+    constructor(config: RerankerConfig);
+    /**
+     * Guard against use-after-dispose
+     */
+    private assertNotDisposed;
+    /**
+     * Check if reranking is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Initialize the reranker model (concurrency-safe).
+     * Multiple concurrent calls will share the same initialization promise.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Rerank candidates by scoring query-document pairs with the cross-encoder.
+     * Returns results sorted by reranker score (descending).
+     */
+    rerank(query: string, candidates: readonly RerankerCandidate[]): Promise<RerankerOutput>;
+    /**
+     * Score a single query-document pair using the cross-encoder.
+     */
+    private scoreQueryDocPair;
+    /**
+     * Check if the reranker is initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if this service has been disposed.
+     */
+    isDisposed(): boolean;
+    /**
+     * Reset the service to uninitialized state, allowing reuse after disposal.
+     */
+    reset(): Promise<void>;
+    /**
+     * Log aggregate reranker debug stats. Only meaningful when BK_DEBUG_RERANKER=1.
+     */
+    static logDebugStats(): void;
+    /**
+     * Dispose the reranker to free resources.
+     */
+    dispose(): Promise<void>;
+}
+
 type SearchMode = 'vector' | 'fts' | 'hybrid';
 /**
  * Search intent hints for context-aware ranking.
@@ -839,6 +949,8 @@ interface SearchResult {
         readonly frameworkBoost: number;
         readonly urlKeywordBoost: number;
         readonly pathKeywordBoost: number;
+        readonly depthBoost: number;
+        readonly entryPointBoost: number;
         readonly rawVectorScore?: number;
     } | undefined;
 }
@@ -852,16 +964,18 @@ interface SearchResponse {
     readonly timeMs: number;
     readonly confidence?: SearchConfidence | undefined;
     readonly maxRawScore?: number | undefined;
+    readonly rerankTimeMs?: number | undefined;
 }
 
 declare class SearchService {
     private readonly lanceStore;
     private readonly codeUnitService;
     private readonly codeGraphService;
+    private readonly rerankerService;
     private readonly graphCache;
     private readonly searchConfig;
     private readonly unsubscribeCacheInvalidation;
-    constructor(lanceStore: LanceStore, codeGraphService?: CodeGraphService, searchConfig?: SearchConfig);
+    constructor(lanceStore: LanceStore, codeGraphService?: CodeGraphService, searchConfig?: SearchConfig, rerankerService?: RerankerService);
     /**
      * Clean up resources (unsubscribe from events).
      * Call this when destroying the service.
@@ -929,6 +1043,21 @@ declare class SearchService {
      * This helps queries like "dispatcher" rank async_dispatcher.py higher.
      */
     private getPathKeywordBoost;
+    /**
+     * Get a depth-based score multiplier, gated by query intent.
+     * Root-level files (depth 0) are boosted for how-to and conceptual queries
+     * where high-level docs/READMEs are most relevant.
+     * Returns 1.0 (no-op) for implementation/debugging/comparison intents
+     * to avoid disturbing candidate ordering before reranker.
+     */
+    private getDepthBoost;
+    /**
+     * Get an entry-point score multiplier, gated by query intent.
+     * Entry-point files (index.ts, main.py, etc.) are boosted for how-to
+     * and implementation queries where API surfaces are most relevant.
+     * Returns 1.0 (no-op) for debugging/comparison/conceptual intents.
+     */
+    private getEntryPointBoost;
     /**
      * Get a score multiplier based on framework context.
      * If query mentions a framework, boost results from that framework's files.
@@ -966,25 +1095,21 @@ declare class SearchService {
  * When stores are created, this service ensures the project's .gitignore
  * is updated to:
  * - Ignore the .bluera/ data directory (not committed)
- * - Allow committing config files (for team sharing)
- *
- * Uses glob-style patterns (`.bluera/*`) for multi-plugin safety and
- * managed `BEGIN`/`END` section markers for clean upgrades.
+ * - Allow committing .bluera/bluera-knowledge/stores.config.json (for team sharing)
  */
 declare class GitignoreService {
     private readonly gitignorePath;
     constructor(projectRoot: string);
     /**
-     * Check if all required patterns are semantically present in .gitignore
+     * Check if all required patterns are present in .gitignore
      */
     hasRequiredPatterns(): Promise<boolean>;
     /**
      * Ensure required .gitignore patterns are present.
      *
      * - Creates .gitignore if it doesn't exist
-     * - Removes existing managed sections (old or new format)
-     * - Appends only semantically missing patterns with BEGIN/END markers
-     * - Persists cleanup even when no patterns are missing
+     * - Appends missing patterns if .gitignore exists
+     * - Does nothing if all patterns are already present
      *
      * @returns Object with updated flag and descriptive message
      */

package/dist/mcp/server.js

@@ -1,10 +1,10 @@
 import {
   createMCPServer,
   runMCPServer
-} from "../chunk-UXT3BCAH.js";
-import "../chunk-WP2GERAJ.js";
+} from "../chunk-AEXFPA57.js";
+import "../chunk-B335UOU7.js";
 import "../chunk-CLIMKLTW.js";
-import "../chunk-H25AEF47.js";
+import "../chunk-N3XYMAU3.js";
 import "../chunk-DGUM43GV.js";
 export {
   createMCPServer,

package/dist/{watch.service-THP6X5ZZ.js → watch.service-LRFCT52P.js}

@@ -1,8 +1,8 @@
 import {
   WatchService
-} from "./chunk-H25AEF47.js";
+} from "./chunk-N3XYMAU3.js";
 import "./chunk-DGUM43GV.js";
 export {
   WatchService
 };
-//# sourceMappingURL=watch.service-THP6X5ZZ.js.map
+//# sourceMappingURL=watch.service-LRFCT52P.js.map

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

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import {
   IntelligentCrawler
-} from "../chunk-BYLIDCWD.js";
+} from "../chunk-KCI4U6FH.js";
 import {
   JobService,
   createLogger,
   createServices,
   destroyServices,
   shutdownLogger
-} from "../chunk-WP2GERAJ.js";
+} from "../chunk-B335UOU7.js";
 import {
   createDocumentId,
   createStoreId
 } from "../chunk-CLIMKLTW.js";
-import "../chunk-H25AEF47.js";
+import "../chunk-N3XYMAU3.js";
 import "../chunk-DGUM43GV.js";
 
 // src/workers/background-worker-cli.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.28.1",
+  "version": "0.30.0",
   "description": "CLI tool for managing knowledge stores with semantic search",
   "type": "module",
   "bin": {
@@ -40,6 +40,14 @@
     "release:patch": "commit-and-tag-version --release-as patch && git push --follow-tags",
     "release:minor": "commit-and-tag-version --release-as minor && git push --follow-tags",
     "release:major": "commit-and-tag-version --release-as major && git push --follow-tags",
+    "bench:search": "bun run benchmarks/search/benchkit/run-bench.ts",
+    "bench:compare": "bun run benchmarks/search/benchkit/compare.ts",
+    "bench:smoke": "bun run bench:search --dataset smoke-v1 --driver service",
+    "models:download": "bun run scripts/download-models.ts",
+    "models:list": "bun run scripts/download-models.ts --list",
+    "training:generate": "bun run training/generate-queries.ts",
+    "training:negatives": "bun run training/mine-negatives.ts",
+    "training:validate": "bun run training/validate.ts",
     "validate:npm": "./scripts/validate-npm-release.sh",
     "validate:local": "./scripts/validate-local.sh",
     "gh:status": "gh run list --limit 5",
@@ -73,6 +81,7 @@
     "LICENSE"
   ],
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.72.1",
     "@eslint/js": "^9.39.2",
     "@types/babel__core": "^7.20.5",
     "@types/babel__traverse": "^7.28.0",
@@ -94,7 +103,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.52.0",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.16",
+    "yaml": "^2.8.2"
   },
   "dependencies": {
     "@babel/parser": "^7.28.5",
@@ -119,7 +129,6 @@
     "pino": "^10.1.0",
     "pino-roll": "^4.0.0",
     "playwright": "^1.58.0",
-    "slurp-ai": "^1.0.6",
     "turndown": "^7.2.2",
     "turndown-plugin-gfm": "^1.0.2",
     "zod": "^4.3.5"

package/dist/chunk-H25AEF47.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/services/watch.service.ts","../src/utils/ignore-patterns.ts","../src/utils/model-validation.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { normalizeGlobPatterns } from '../utils/ignore-patterns.js';\nimport { validateStoreModelCompatibility } from '../utils/model-validation.js';\nimport type { IndexService } from './index.service.js';\nimport type { EmbeddingEngine } from '../db/embeddings.js';\nimport type { LanceStore } from '../db/lance.js';\nimport type { FileStore, RepoStore } from '../types/store.js';\n\nexport interface WatchServiceOptions {\n  ignorePatterns?: readonly string[];\n  /** Current embedding model ID for compatibility validation */\n  currentModelId?: string;\n}\n\nexport class WatchService {\n  private readonly watchers: Map<string, FSWatcher> = new Map();\n  private readonly pendingTimeouts: Map<string, NodeJS.Timeout> = new Map();\n  private readonly indexService: IndexService;\n  private readonly lanceStore: LanceStore;\n  private readonly embeddings: EmbeddingEngine;\n  private readonly ignorePatterns: readonly string[];\n  private readonly currentModelId: string | undefined;\n\n  constructor(\n    indexService: IndexService,\n    lanceStore: LanceStore,\n    embeddings: EmbeddingEngine,\n    options: WatchServiceOptions = {}\n  ) {\n    this.indexService = indexService;\n    this.lanceStore = lanceStore;\n    this.embeddings = embeddings;\n    // Use shared utility to normalize patterns to glob format with defaults\n    this.ignorePatterns = normalizeGlobPatterns(options.ignorePatterns ?? []);\n    this.currentModelId = options.currentModelId;\n  }\n\n  async watch(\n    store: FileStore | RepoStore,\n    debounceMs: number,\n    onReindex: (() => void) | undefined,\n    onError: (error: Error) => void\n  ): Promise<void> {\n    if (this.watchers.has(store.id)) {\n      return Promise.resolve(); // Already watching\n    }\n\n    let timeout: NodeJS.Timeout | null = null;\n\n    const watcher = watch(store.path, {\n      ignored: [...this.ignorePatterns],\n      persistent: true,\n      ignoreInitial: true,\n    });\n\n    const reindexHandler = (): void => {\n      if (timeout) clearTimeout(timeout);\n      timeout = setTimeout(() => {\n        this.pendingTimeouts.delete(store.id);\n        void (async (): Promise<void> => {\n          try {\n            // Validate model compatibility before incremental indexing\n            // If currentModelId is set, check that store was indexed with same model\n            if (this.currentModelId !== undefined) {\n              validateStoreModelCompatibility(store, { currentModelId: this.currentModelId });\n            }\n\n            this.lanceStore.setDimensions(await this.embeddings.ensureDimensions());\n            await this.lanceStore.initialize(store.id);\n\n            // Try incremental indexing first if available, fall back to full indexing\n            let useFullReindex = true;\n            if (typeof this.indexService.indexStoreIncremental === 'function') {\n              const incrementalResult = await this.indexService.indexStoreIncremental(store);\n              if (incrementalResult.success) {\n                useFullReindex = false;\n              }\n            }\n\n            if (useFullReindex) {\n              const fullResult = await this.indexService.indexStore(store);\n              if (!fullResult.success) {\n                onError(fullResult.error);\n                return;\n              }\n            }\n\n            onReindex?.();\n          } catch (e) {\n            const error = e instanceof Error ? e : new Error(String(e));\n            onError(error);\n          }\n        })();\n      }, debounceMs);\n      this.pendingTimeouts.set(store.id, timeout);\n    };\n\n    watcher.on('all', reindexHandler);\n\n    watcher.on('error', (e) => {\n      const error = e instanceof Error ? e : new Error(String(e));\n      onError(error);\n    });\n\n    this.watchers.set(store.id, watcher);\n    return Promise.resolve();\n  }\n\n  async unwatch(storeId: string): Promise<void> {\n    // Clear any pending timeout to prevent timer leak\n    const pendingTimeout = this.pendingTimeouts.get(storeId);\n    if (pendingTimeout) {\n      clearTimeout(pendingTimeout);\n      this.pendingTimeouts.delete(storeId);\n    }\n\n    const watcher = this.watchers.get(storeId);\n    if (watcher) {\n      await watcher.close();\n      this.watchers.delete(storeId);\n    }\n  }\n\n  async unwatchAll(): Promise<void> {\n    for (const [id] of this.watchers) {\n      await this.unwatch(id);\n    }\n  }\n}\n","/**\n * Unified ignore pattern handling for consistent behavior across IndexService and WatchService.\n *\n * Pattern normalization ensures the same config patterns work identically whether used\n * for fs.readdir scanning (IndexService) or chokidar watching (WatchService).\n */\n\n/** Default directories to always ignore */\nexport const DEFAULT_IGNORE_DIRS = ['node_modules', '.git', '.bluera', 'dist', 'build'] as const;\n\n/**\n * Normalize patterns to standard glob format for chokidar and micromatch.\n *\n * Transformations:\n * - 'node_modules' → '** /node_modules/**' (directory anywhere in tree)\n * - 'node_modules/**' → '** /node_modules/**' (explicit directory pattern)\n * - '*.min.js' → '**\\/*.min.js' (extension pattern anywhere)\n * - '** /foo/**' → unchanged (already in glob format)\n *\n * @param patterns - User-provided patterns from config\n * @param includeDefaults - Whether to include DEFAULT_IGNORE_DIRS (default: true)\n */\nexport function normalizeGlobPatterns(\n  patterns: readonly string[],\n  includeDefaults = true\n): string[] {\n  const result: string[] = [];\n\n  // Add defaults first\n  if (includeDefaults) {\n    for (const dir of DEFAULT_IGNORE_DIRS) {\n      result.push(`**/${dir}/**`);\n    }\n  }\n\n  // Process user patterns\n  for (const pattern of patterns) {\n    if (pattern.startsWith('**/') && pattern.endsWith('/**')) {\n      // Already in glob format\n      result.push(pattern);\n    } else if (pattern.endsWith('/**')) {\n      // Directory pattern: 'foo/**' → '**/foo/**'\n      result.push(`**/${pattern}`);\n    } else if (pattern.startsWith('*.')) {\n      // Extension pattern: '*.min.js' → '**/*.min.js'\n      result.push(`**/${pattern}`);\n    } else if (!pattern.includes('/') && !pattern.includes('*')) {\n      // Simple directory name: 'node_modules' → '**/node_modules/**'\n      result.push(`**/${pattern}/**`);\n    } else {\n      // Keep as-is (might be a specific path pattern)\n      result.push(pattern);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Parsed patterns optimized for fs.readdir scanning.\n */\nexport interface ScanningPatterns {\n  /** Directory names to skip during traversal (e.g., 'node_modules', '.git') */\n  dirs: Set<string>;\n  /** Predicate functions to test if a filename should be ignored (e.g., for '*.min.js') */\n  fileMatchers: Array<(filename: string) => boolean>;\n}\n\n/**\n * Parse patterns into structures optimized for fs.readdir filtering.\n *\n * This is more efficient than glob matching for directory traversal since\n * it allows early termination when encountering ignored directories.\n *\n * @param patterns - User-provided patterns from config\n * @param includeDefaults - Whether to include DEFAULT_IGNORE_DIRS (default: true)\n */\nexport function parseIgnorePatternsForScanning(\n  patterns: readonly string[],\n  includeDefaults = true\n): ScanningPatterns {\n  const dirs = new Set<string>();\n  const fileMatchers: Array<(filename: string) => boolean> = [];\n\n  // Add defaults first\n  if (includeDefaults) {\n    for (const dir of DEFAULT_IGNORE_DIRS) {\n      dirs.add(dir);\n    }\n  }\n\n  // Process user patterns\n  for (const pattern of patterns) {\n    if (pattern.startsWith('**/') && pattern.endsWith('/**')) {\n      // Glob format: '**/node_modules/**' → extract 'node_modules'\n      const inner = pattern.slice(3, -3);\n      if (!inner.includes('/') && !inner.includes('*')) {\n        dirs.add(inner);\n      }\n    } else if (pattern.endsWith('/**')) {\n      // Directory pattern: 'node_modules/**' → 'node_modules'\n      dirs.add(pattern.slice(0, -3));\n    } else if (pattern.startsWith('*.')) {\n      // Extension pattern: '*.min.js' → matches files ending with '.min.js'\n      const ext = pattern.slice(1); // Remove leading '*'\n      fileMatchers.push((filename) => filename.endsWith(ext));\n    } else if (!pattern.includes('/') && !pattern.includes('*')) {\n      // Simple directory name: 'node_modules' → treat as directory\n      dirs.add(pattern);\n    }\n    // Note: Complex patterns like 'src/**/*.test.ts' are not supported for scanning\n    // They would require full glob matching which defeats the purpose of fast scanning\n  }\n\n  return { dirs, fileMatchers };\n}\n","/**\n * Model Compatibility Validation\n *\n * Guards against searching or incrementally indexing stores with mismatched embedding models.\n * Ensures stores are only queried with the same model they were indexed with.\n */\n\nimport type { Store } from '../types/store.js';\n\nexport interface ModelValidationContext {\n  currentModelId: string;\n}\n\n/**\n * Validates that a store's embedding model matches the current configuration.\n *\n * @throws Error if store was indexed with a different model or has no model tracking\n */\nexport function validateStoreModelCompatibility(store: Store, ctx: ModelValidationContext): void {\n  // Stores without modelId (schemaVersion < 2) must be reindexed\n  if (!store.modelId) {\n    throw new Error(\n      `Store \"${store.name}\" has no model tracking (schema v1). ` +\n        `Reindex required: /bluera-knowledge:index ${store.name}`\n    );\n  }\n\n  if (store.modelId !== ctx.currentModelId) {\n    throw new Error(\n      `Model mismatch: Store \"${store.name}\" was indexed with \"${store.modelId}\", ` +\n        `but current config uses \"${ctx.currentModelId}\". ` +\n        `Reindex required: /bluera-knowledge:index ${store.name}`\n    );\n  }\n}\n\n/**\n * Check if a store's model matches the current configuration without throwing.\n *\n * @returns Object with compatibility status and details\n */\nexport function checkStoreModelCompatibility(\n  store: Store,\n  ctx: ModelValidationContext\n): {\n  compatible: boolean;\n  modelId: string | undefined;\n  reason?: string;\n} {\n  if (!store.modelId) {\n    return {\n      compatible: false,\n      modelId: undefined,\n      reason: 'Store has no model tracking (schema v1)',\n    };\n  }\n\n  if (store.modelId !== ctx.currentModelId) {\n    return {\n      compatible: false,\n      modelId: store.modelId,\n      reason: `Indexed with different model: ${store.modelId}`,\n    };\n  }\n\n  return {\n    compatible: true,\n    modelId: store.modelId,\n  };\n}\n"],"mappings":"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","names":[]}