bluera-knowledge 0.25.1 → 0.27.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 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.27.0](https://github.com/blueraai/bluera-knowledge/compare/v0.26.0...v0.27.0) (2026-02-05)
+
+
+### Features
+
+* **hooks:** conditional BK enforcement on library reads ([1d7ff96](https://github.com/blueraai/bluera-knowledge/commit/1d7ff96ea38c1afda970c1cbaae3b3edb2b1bd0f))
+
+
+### Bug Fixes
+
+* **lance:** remove .lance directory on store deletion ([08cccef](https://github.com/blueraai/bluera-knowledge/commit/08cccef8dae943abf4f71b0f65a6a21b1a8b5110))
+
+## [0.26.0](https://github.com/blueraai/bluera-knowledge/compare/v0.25.1...v0.26.0) (2026-02-04)
+
+
+### Features
+
+* **cli:** add store health command ([1321522](https://github.com/blueraai/bluera-knowledge/commit/13215227f02d8e791cb5b2a4d61a4e509fe001f4))
+* **index:** add web store re-indexing via crawl jobs ([cf3d4cd](https://github.com/blueraai/bluera-knowledge/commit/cf3d4cda084973eaf0dbd4a17c9ba916669f9fa1))
+* **mcp:** add stores:health command ([6e342f8](https://github.com/blueraai/bluera-knowledge/commit/6e342f827474a3c84ff82fad15bfcf7764ae9c80))
+* **store:** add path resolution for portable store paths ([cf451db](https://github.com/blueraai/bluera-knowledge/commit/cf451db6c368ca82ee1c72fe0b6b69a9544e7aba))
+* **types:** add pathType for portable store paths (schema v3) ([519b3c6](https://github.com/blueraai/bluera-knowledge/commit/519b3c6541b792d955a5b90a237b03622f1c18be))
+
 ## [0.25.1](https://github.com/blueraai/bluera-knowledge/compare/v0.25.0...v0.25.1) (2026-02-04)
 
 ## [0.25.0](https://github.com/blueraai/bluera-knowledge/compare/v0.22.4...v0.25.0) (2026-02-04)

package/dist/{chunk-L6P43FR7.js → chunk-GB5WKUBX.js}

@@ -4753,6 +4753,7 @@ var IngestConfigSchema = z3.object({
 var FileStoreDefinitionSchema = BaseStoreDefinitionSchema.extend({
   type: z3.literal("file"),
   path: z3.string().min(1, "Path is required for file stores"),
+  pathType: z3.enum(["relative", "absolute"]).optional(),
   ingest: IngestConfigSchema.optional()
 });
 var GitUrlSchema = z3.string().refine(
@@ -4958,7 +4959,7 @@ var StoreDefinitionService = class {
 // src/services/store.service.ts
 import { randomUUID as randomUUID2 } from "crypto";
 import { readFile as readFile8, mkdir as mkdir5, stat as stat3, access as access5 } from "fs/promises";
-import { join as join10, resolve as resolve3 } from "path";
+import { join as join10, resolve as resolve3, relative as relative2, isAbsolute as isAbsolute3 } from "path";
 
 // src/plugin/git-clone.ts
 import { spawn } from "child_process";
@@ -5054,9 +5055,10 @@ function extractRepoName(url) {
 }
 
 // src/types/store.ts
-var CURRENT_SCHEMA_VERSION = 2;
+var CURRENT_SCHEMA_VERSION = 3;
 
 // src/services/store.service.ts
+var logger4 = createLogger("store-service");
 async function fileExists4(path4) {
   try {
     await access5(path4);
@@ -5073,6 +5075,8 @@ var StoreService = class {
   embeddingModelId;
   registry = { stores: [] };
   registryMtime = 0;
+  /** Flag for lazy schema migration - bump to v3 on next save */
+  needsMigration = false;
   constructor(dataDir, options) {
     this.dataDir = dataDir;
     this.definitionService = options.definitionService ?? void 0;
@@ -5087,6 +5091,47 @@ var StoreService = class {
   getCurrentModelId() {
     return this.embeddingModelId;
   }
+  /**
+   * Convert an absolute path to stored format.
+   * Returns relative path + pathType if inside projectRoot, otherwise absolute.
+   *
+   * @param absolutePath - The absolute path to convert
+   * @param isClonedRepo - If true, always store absolute (managed by BK under dataDir)
+   */
+  toStoredPath(absolutePath, isClonedRepo = false) {
+    if (isClonedRepo) {
+      return { path: absolutePath, pathType: "absolute" };
+    }
+    if (this.projectRoot === void 0) {
+      return { path: absolutePath, pathType: "absolute" };
+    }
+    const relativePath = relative2(this.projectRoot, absolutePath);
+    if (relativePath.startsWith("..") || isAbsolute3(relativePath)) {
+      logger4.info(`Path outside projectRoot, storing absolute: ${absolutePath}`);
+      return { path: absolutePath, pathType: "absolute" };
+    }
+    logger4.debug(`Storing relative path: ${relativePath} (resolved from ${absolutePath})`);
+    return { path: relativePath, pathType: "relative" };
+  }
+  /**
+   * Resolve a stored path to absolute runtime path.
+   * Handles both relative (v3+) and absolute (v2 and earlier) paths.
+   *
+   * @param storedPath - The path as stored in stores.json
+   * @param pathType - The path type (undefined for pre-v3 stores, treated as absolute)
+   */
+  resolveStoredPath(storedPath, pathType) {
+    if (pathType === void 0 || pathType === "absolute") {
+      return storedPath;
+    }
+    if (this.projectRoot === void 0) {
+      logger4.error(`Store has relative path but no projectRoot: ${storedPath}`);
+      return storedPath;
+    }
+    const resolved = resolve3(this.projectRoot, storedPath);
+    logger4.debug(`Resolved relative path: ${storedPath} \u2192 ${resolved}`);
+    return resolved;
+  }
   async initialize() {
     await mkdir5(this.dataDir, { recursive: true });
     await this.loadRegistry();
@@ -5123,7 +5168,8 @@ var StoreService = class {
           ...base,
           type: "file",
           // Use original input path if provided (may be relative), otherwise use normalized
-          path: input.path ?? fileStore.path
+          path: input.path ?? fileStore.path,
+          pathType: fileStore.pathType
         };
         return fileDef;
       }
@@ -5173,7 +5219,8 @@ var StoreService = class {
         const fileDef = {
           ...base,
           type: "file",
-          path: store.path
+          path: store.path,
+          pathType: store.pathType
         };
         return fileDef;
       }
@@ -5229,11 +5276,13 @@ var StoreService = class {
         } catch {
           return err(new Error(`Directory does not exist: ${normalizedPath}`));
         }
+        const { pathType } = this.toStoredPath(normalizedPath, false);
         store = {
           type: "file",
           id,
           name: input.name,
           path: normalizedPath,
+          pathType,
           ingest: input.ingest,
           description: input.description,
           tags: input.tags,
@@ -5275,11 +5324,14 @@ var StoreService = class {
             return err(new Error(`Repository path does not exist: ${normalizedRepoPath}`));
           }
         }
+        const isClonedRepo = input.url !== void 0;
+        const { pathType: repoPathType } = this.toStoredPath(normalizedRepoPath, isClonedRepo);
         store = {
           type: "repo",
           id,
           name: input.name,
           path: normalizedRepoPath,
+          pathType: repoPathType,
           url: input.url,
           branch: input.branch,
           depth: input.depth ?? 1,
@@ -5458,14 +5510,32 @@ var StoreService = class {
     const content = await readFile8(registryPath, "utf-8");
     try {
       const data = JSON.parse(content);
+      let migrationNeeded = false;
       this.registry = {
-        stores: data.stores.filter((s) => s !== null).map((s) => ({
-          ...s,
-          id: createStoreId(s.id),
-          createdAt: new Date(s.createdAt),
-          updatedAt: new Date(s.updatedAt)
-        }))
+        stores: data.stores.filter((s) => s !== null).map((s) => {
+          if (s.schemaVersion === void 0 || s.schemaVersion < CURRENT_SCHEMA_VERSION) {
+            migrationNeeded = true;
+          }
+          let store = {
+            ...s,
+            id: createStoreId(s.id),
+            createdAt: new Date(s.createdAt),
+            updatedAt: new Date(s.updatedAt)
+          };
+          if (store.type === "file") {
+            const resolvedPath = this.resolveStoredPath(store.path, store.pathType);
+            store = { ...store, path: resolvedPath };
+          } else if (store.type === "repo") {
+            const resolvedPath = this.resolveStoredPath(store.path, store.pathType);
+            store = { ...store, path: resolvedPath };
+          }
+          return store;
+        })
       };
+      if (migrationNeeded) {
+        logger4.debug("Schema migration needed - will upgrade on next save");
+        this.needsMigration = true;
+      }
     } catch (error) {
       throw new Error(
         `Failed to parse store registry at ${registryPath}: ${error instanceof Error ? error.message : String(error)}`
@@ -5476,7 +5546,37 @@ var StoreService = class {
   }
   async saveRegistry() {
     const registryPath = join10(this.dataDir, "stores.json");
-    await atomicWriteFile(registryPath, JSON.stringify(this.registry, null, 2));
+    const storedStores = this.registry.stores.map((store) => {
+      const schemaVersion = this.needsMigration ? CURRENT_SCHEMA_VERSION : store.schemaVersion;
+      if (store.type === "file") {
+        const { path: storedPath, pathType } = this.toStoredPath(store.path, false);
+        return {
+          ...store,
+          path: storedPath,
+          pathType,
+          schemaVersion
+        };
+      } else if (store.type === "repo") {
+        const isClonedRepo = store.url !== void 0;
+        const { path: storedPath, pathType } = this.toStoredPath(store.path, isClonedRepo);
+        return {
+          ...store,
+          path: storedPath,
+          pathType,
+          schemaVersion
+        };
+      } else {
+        return {
+          ...store,
+          schemaVersion
+        };
+      }
+    });
+    if (this.needsMigration) {
+      logger4.info("Schema migration complete - upgraded to v3");
+      this.needsMigration = false;
+    }
+    await atomicWriteFile(registryPath, JSON.stringify({ stores: storedStores }, null, 2));
   }
 };
 
@@ -5524,7 +5624,7 @@ function validateParsePythonResult(data) {
 }
 
 // src/crawl/bridge.ts
-var logger4 = createLogger("python-bridge");
+var logger5 = createLogger("python-bridge");
 function getPythonExecutable() {
   return process.platform === "win32" ? "python" : "python3";
 }
@@ -5559,7 +5659,7 @@ var PythonBridge = class {
       pythonWorkerPath = path3.join(projectRoot, "python", "ast_worker.py");
       pythonPath = getPythonExecutable();
     }
-    logger4.debug(
+    logger5.debug(
       { pythonWorkerPath, pythonPath, currentFilePath, isProduction },
       "Starting Python bridge process"
     );
@@ -5567,15 +5667,15 @@ var PythonBridge = class {
       stdio: ["pipe", "pipe", "pipe"]
     });
     this.process.on("error", (err2) => {
-      logger4.error({ error: err2.message, stack: err2.stack }, "Python bridge process error");
+      logger5.error({ error: err2.message, stack: err2.stack }, "Python bridge process error");
       this.rejectAllPending(new Error(`Process error: ${err2.message}`));
     });
     this.process.on("exit", (code, signal) => {
       if (code !== 0 && code !== null) {
-        logger4.error({ code }, "Python bridge process exited with non-zero code");
+        logger5.error({ code }, "Python bridge process exited with non-zero code");
         this.rejectAllPending(new Error(`Process exited with code ${String(code)}`));
       } else if (signal && !this.stoppingIntentionally) {
-        logger4.error({ signal }, "Python bridge process killed with signal");
+        logger5.error({ signal }, "Python bridge process killed with signal");
         this.rejectAllPending(new Error(`Process killed with signal ${signal}`));
       }
       this.process = null;
@@ -5584,7 +5684,7 @@ var PythonBridge = class {
     if (this.process.stderr) {
       this.stderrReadline = createInterface({ input: this.process.stderr });
       this.stderrReadline.on("line", (line) => {
-        logger4.warn({ stderr: line }, "Python bridge stderr output");
+        logger5.warn({ stderr: line }, "Python bridge stderr output");
       });
     }
     if (this.process.stdout === null) {
@@ -5613,7 +5713,7 @@ var PythonBridge = class {
               pending.resolve(validated);
             } catch (error) {
               if (error instanceof ZodError) {
-                logger4.error(
+                logger5.error(
                   {
                     issues: error.issues,
                     response: JSON.stringify(response.result)
@@ -5625,14 +5725,14 @@ var PythonBridge = class {
                 );
               } else {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                logger4.error({ error: errorMessage }, "Response validation error");
+                logger5.error({ error: errorMessage }, "Response validation error");
                 pending.reject(new Error(`Response validation error: ${errorMessage}`));
               }
             }
           }
         }
       } catch (err2) {
-        logger4.error(
+        logger5.error(
           {
             error: err2 instanceof Error ? err2.message : String(err2),
             line
@@ -5962,6 +6062,8 @@ var EmbeddingEngine = class {
 };
 
 // src/db/lance.ts
+import { rm as rm2 } from "fs/promises";
+import { join as join12 } from "path";
 import * as lancedb from "@lancedb/lancedb";
 import { LanceSchema } from "@lancedb/lancedb/embedding";
 import { Utf8 } from "apache-arrow";
@@ -6062,6 +6164,7 @@ var DocumentMetadataSchema = z5.object({
 }).loose();
 
 // src/db/lance.ts
+var logger6 = createLogger("lance");
 function isSearchHit(value) {
   if (typeof value !== "object" || value === null) return false;
   return "id" in value && "content" in value && "metadata" in value && "_distance" in value && typeof value.id === "string" && typeof value.content === "string" && typeof value.metadata === "string" && typeof value._distance === "number";
@@ -6239,7 +6342,13 @@ var LanceStore = class {
     const tableNames = await this.connection.tableNames();
     if (tableNames.includes(tableName)) {
       await this.connection.dropTable(tableName);
-      this.tables.delete(tableName);
+    }
+    this.tables.delete(tableName);
+    const lanceDir = join12(this.dataDir, `${tableName}.lance`);
+    try {
+      await rm2(lanceDir, { recursive: true, force: true });
+    } catch (error) {
+      logger6.warn({ lanceDir, error }, "Failed to remove .lance directory");
     }
   }
   close() {
@@ -6276,7 +6385,7 @@ var LanceStore = class {
 };
 
 // src/services/index.ts
-var logger5 = createLogger("services");
+var logger7 = createLogger("services");
 var LazyServiceContainer = class {
   // Eagerly initialized (lightweight)
   config;
@@ -6307,7 +6416,7 @@ var LazyServiceContainer = class {
    */
   get embeddings() {
     if (this._embeddings === null) {
-      logger5.debug("Lazy-initializing EmbeddingEngine");
+      logger7.debug("Lazy-initializing EmbeddingEngine");
       this._embeddings = new EmbeddingEngine(this.appConfig.embedding);
     }
     return this._embeddings;
@@ -6317,7 +6426,7 @@ var LazyServiceContainer = class {
    */
   get codeGraph() {
     if (this._codeGraph === null) {
-      logger5.debug("Lazy-initializing CodeGraphService");
+      logger7.debug("Lazy-initializing CodeGraphService");
       this._codeGraph = new CodeGraphService(this.dataDir, this.pythonBridge);
     }
     return this._codeGraph;
@@ -6327,7 +6436,7 @@ var LazyServiceContainer = class {
    */
   get search() {
     if (this._search === null) {
-      logger5.debug("Lazy-initializing SearchService");
+      logger7.debug("Lazy-initializing SearchService");
       this._search = new SearchService(this.lance, this.codeGraph, this.appConfig.search);
     }
     return this._search;
@@ -6337,7 +6446,7 @@ var LazyServiceContainer = class {
    */
   get index() {
     if (this._index === null) {
-      logger5.debug("Lazy-initializing IndexService");
+      logger7.debug("Lazy-initializing IndexService");
       this._index = new IndexService(this.lance, this.embeddings, {
         codeGraphService: this.codeGraph,
         manifestService: this.manifest,
@@ -6354,7 +6463,7 @@ var LazyServiceContainer = class {
    */
   get manifest() {
     if (this._manifest === null) {
-      logger5.debug("Lazy-initializing ManifestService");
+      logger7.debug("Lazy-initializing ManifestService");
       this._manifest = new ManifestService(this.dataDir);
     }
     return this._manifest;
@@ -6373,7 +6482,7 @@ var LazyServiceContainer = class {
   }
 };
 async function createLazyServices(configPath, dataDir, projectRoot) {
-  logger5.info({ configPath, dataDir, projectRoot }, "Initializing lazy services");
+  logger7.info({ configPath, dataDir, projectRoot }, "Initializing lazy services");
   const startTime = Date.now();
   const config = new ConfigService(configPath, dataDir, projectRoot);
   const appConfig = await config.load();
@@ -6394,14 +6503,14 @@ async function createLazyServices(configPath, dataDir, projectRoot) {
   await store.initialize();
   await lance.setEmbeddingFunction(appConfig.embedding);
   const durationMs = Date.now() - startTime;
-  logger5.info(
+  logger7.info(
     { dataDir: resolvedDataDir, projectRoot: resolvedProjectRoot, durationMs },
     "Lazy services initialized"
   );
   return new LazyServiceContainer(config, appConfig, resolvedDataDir, store, lance, pythonBridge);
 }
 async function createServices(configPath, dataDir, projectRoot) {
-  logger5.info({ configPath, dataDir, projectRoot }, "Initializing services");
+  logger7.info({ configPath, dataDir, projectRoot }, "Initializing services");
   const config = new ConfigService(configPath, dataDir, projectRoot);
   const appConfig = await config.load();
   const resolvedDataDir = config.resolveDataDir();
@@ -6433,7 +6542,7 @@ async function createServices(configPath, dataDir, projectRoot) {
     concurrency: appConfig.indexing.concurrency,
     ignorePatterns: appConfig.indexing.ignorePatterns
   });
-  logger5.info(
+  logger7.info(
     { dataDir: resolvedDataDir, projectRoot: resolvedProjectRoot },
     "Services initialized successfully"
   );
@@ -6450,20 +6559,20 @@ async function createServices(configPath, dataDir, projectRoot) {
   };
 }
 async function destroyServices(services) {
-  logger5.info("Shutting down services");
+  logger7.info("Shutting down services");
   const errors = [];
   const isLazyContainer = services instanceof LazyServiceContainer;
   const shouldCleanupSearch = !isLazyContainer || services.hasSearch;
   if (shouldCleanupSearch) {
     services.search.cleanup();
   } else {
-    logger5.debug("Skipping search cleanup (not initialized)");
+    logger7.debug("Skipping search cleanup (not initialized)");
   }
   try {
     await services.pythonBridge.stop();
   } catch (e) {
     const error = e instanceof Error ? e : new Error(String(e));
-    logger5.error({ error }, "Error stopping Python bridge");
+    logger7.error({ error }, "Error stopping Python bridge");
     errors.push(error);
   }
   const shouldDisposeEmbeddings = !isLazyContainer || services.hasEmbeddings;
@@ -6472,17 +6581,17 @@ async function destroyServices(services) {
       await services.embeddings.dispose();
     } catch (e) {
       const error = e instanceof Error ? e : new Error(String(e));
-      logger5.error({ error }, "Error disposing EmbeddingEngine");
+      logger7.error({ error }, "Error disposing EmbeddingEngine");
       errors.push(error);
     }
   } else {
-    logger5.debug("Skipping embeddings disposal (not initialized)");
+    logger7.debug("Skipping embeddings disposal (not initialized)");
   }
   try {
     await services.lance.closeAsync();
   } catch (e) {
     const error = e instanceof Error ? e : new Error(String(e));
-    logger5.error({ error }, "Error closing LanceStore");
+    logger7.error({ error }, "Error closing LanceStore");
     errors.push(error);
   }
   await shutdownLogger();
@@ -6516,4 +6625,4 @@ export {
   createServices,
   destroyServices
 };
-//# sourceMappingURL=chunk-L6P43FR7.js.map
+//# sourceMappingURL=chunk-GB5WKUBX.js.map