ctxloom-pro 1.7.7 → 1.7.8

package/README.md

@@ -69,7 +69,7 @@ The full first-run flow is **one install + one trial + one init per project.** E
 npm install -g ctxloom-pro
 ```
 
-> **For local trial / dev use the unpinned command above is fine.** For unattended CI usage, pin to the exact version (`ctxloom-pro@1.7.7`) so future CLI releases don't silently desync your agent-spec coverage — see the workflow example below.
+> **For local trial / dev use the unpinned command above is fine.** For unattended CI usage, pin to the exact version (`ctxloom-pro@1.7.8`) so future CLI releases don't silently desync your agent-spec coverage — see the workflow example below.
 
 ### 2 — Start your free trial (once per email)
 
@@ -383,7 +383,7 @@ jobs:
       # Exact pin (not `@^1`) so future CLI releases that add/remove MCP
       # tools don't silently desync your reviewer-agent specs. Bump on
       # every release; see CHANGELOG.md for the live version table.
-      - run: npm install -g ctxloom-pro@1.7.7
+      - run: npm install -g ctxloom-pro@1.7.8
       - run: ctxloom index
       - run: ctxloom rules check --json
 ```

package/apps/dashboard/dist/server/index.js

@@ -2929,7 +2929,7 @@ var CallGraphIndex = class _CallGraphIndex {
 var TS_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".vue"]);
 var PY_EXTENSIONS = /* @__PURE__ */ new Set([".py", ".ipynb"]);
 var AST_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".py", ".go", ".rs", ".java", ".cs", ".rb", ".kt", ".kts", ".swift", ".ipynb", ".php", ".dart"]);
-var CTXLOOM_VERSION = "1.7.7".length > 0 ? "1.7.7" : "dev";
+var CTXLOOM_VERSION = "1.7.8".length > 0 ? "1.7.8" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -12335,7 +12335,7 @@ function resolveTelemetryLevel() {
 }
 var TELEMETRY_LEVEL = resolveTelemetryLevel();
 var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
-var CTXLOOM_VERSION2 = "1.7.7".length > 0 ? "1.7.7" : "dev";
+var CTXLOOM_VERSION2 = "1.7.8".length > 0 ? "1.7.8" : "dev";
 var POSTHOG_HOST = "https://eu.i.posthog.com";
 var POSTHOG_KEY = process.env["POSTHOG_API_KEY"] ?? (true ? "phc_CiDkmFLcZ2K6uCpcoSUQLmFrnnUvsyXGhSxopX5TVKE6" : "");
 var SENTRY_DSN = process.env["SENTRY_DSN"] ?? (true ? "https://81c94a0f04a8e242dee493ac1e17f733@o4508531702497280.ingest.de.sentry.io/4511256875368528" : "");

package/dist/VectorStore-IHNQ3NOD.js

@@ -0,0 +1,9 @@
+import {
+  VectorStore
+} from "./chunk-Z3NQHCWG.js";
+import "./chunk-R32CUQAL.js";
+import "./chunk-TYDMSHV7.js";
+export {
+  VectorStore
+};
+//# sourceMappingURL=VectorStore-IHNQ3NOD.js.map

package/dist/{chunk-OEDNX3CV.js → chunk-7WLMI4AD.js}

@@ -1,11 +1,11 @@
 import {
   VectorStore
-} from "./chunk-XQEQLXY5.js";
+} from "./chunk-Z3NQHCWG.js";
 import {
   collectFiles,
   generateEmbedding,
   isIgnoredDir
-} from "./chunk-JZOJC3S7.js";
+} from "./chunk-R32CUQAL.js";
 import {
   diskSink,
   readEvents
@@ -2705,7 +2705,7 @@ var CallGraphIndex = class _CallGraphIndex {
 var TS_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".vue"]);
 var PY_EXTENSIONS = /* @__PURE__ */ new Set([".py", ".ipynb"]);
 var AST_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".py", ".go", ".rs", ".java", ".cs", ".rb", ".kt", ".kts", ".swift", ".ipynb", ".php", ".dart"]);
-var CTXLOOM_VERSION = "1.7.7".length > 0 ? "1.7.7" : "dev";
+var CTXLOOM_VERSION = "1.7.8".length > 0 ? "1.7.8" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -8867,7 +8867,7 @@ function registerFullTextSearchTool(registry, ctx) {
       };
       if (mode === "semantic") {
         try {
-          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-4MM7D3UE.js");
+          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-E2GDBGOH.js");
           const store = await ctx.getStore(project_root);
           const embedding = await generateEmbedding2(query);
           const results = await store.search(embedding, limit);
@@ -8905,7 +8905,7 @@ function registerFullTextSearchTool(registry, ctx) {
       let merged = keywordResults.slice(0, limit);
       if (mode === "hybrid") {
         try {
-          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-4MM7D3UE.js");
+          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-E2GDBGOH.js");
           const store = await ctx.getStore(project_root);
           const embedding = await generateEmbedding2(query);
           const vectorResults = await store.search(embedding, Math.ceil(limit / 2));
@@ -11142,7 +11142,7 @@ var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
 function getTelemetryLevel() {
   return TELEMETRY_LEVEL;
 }
-var CTXLOOM_VERSION2 = "1.7.7".length > 0 ? "1.7.7" : "dev";
+var CTXLOOM_VERSION2 = "1.7.8".length > 0 ? "1.7.8" : "dev";
 var POSTHOG_HOST = "https://eu.i.posthog.com";
 var POSTHOG_KEY = process.env["POSTHOG_API_KEY"] ?? (true ? "phc_CiDkmFLcZ2K6uCpcoSUQLmFrnnUvsyXGhSxopX5TVKE6" : "");
 var SENTRY_DSN = process.env["SENTRY_DSN"] ?? (true ? "https://81c94a0f04a8e242dee493ac1e17f733@o4508531702497280.ingest.de.sentry.io/4511256875368528" : "");
@@ -12828,4 +12828,4 @@ export {
   skillFilePath,
   installHarness
 };
-//# sourceMappingURL=chunk-OEDNX3CV.js.map
+//# sourceMappingURL=chunk-7WLMI4AD.js.map

package/dist/{chunk-JZOJC3S7.js → chunk-R32CUQAL.js}

@@ -253,7 +253,7 @@ var INDEX_SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ipynb"
 ]);
 async function indexDirectory(rootDir, onProgress) {
-  const { VectorStore } = await import("./VectorStore-5ALWL6XF.js");
+  const { VectorStore } = await import("./VectorStore-IHNQ3NOD.js");
   const store = new VectorStore(path.join(rootDir, ".ctxloom", "vectors.lancedb"));
   await store.init();
   let indexed = 0;
@@ -366,4 +366,4 @@ export {
   EMBEDDING_MODEL_ID,
   getActiveEmbeddingModel
 };
-//# sourceMappingURL=chunk-JZOJC3S7.js.map
+//# sourceMappingURL=chunk-R32CUQAL.js.map

package/dist/{chunk-XQEQLXY5.js → chunk-Z3NQHCWG.js}

@@ -1,7 +1,7 @@
 import {
   EMBEDDING_DIMENSION,
   EMBEDDING_MODEL_ID
-} from "./chunk-JZOJC3S7.js";
+} from "./chunk-R32CUQAL.js";
 import {
   logger
 } from "./chunk-TYDMSHV7.js";
@@ -26,6 +26,27 @@ var VectorStore = class {
   upsertsSinceCompact = 0;
   compactEvery;
   cleanupOlderThanMs;
+  /**
+   * Hot-reload bookkeeping (v1.7.8). A live MCP server pins one open
+   * LanceDB table handle. When a terminal `ctxloom index` rewrites the
+   * store on the same path, the pinned handle keeps serving the OLD
+   * version — `ctx_search` returns stale/empty results until restart
+   * (the vector analogue of the graph hot-reload shipped in v1.7.5).
+   *
+   * Fix: before each read we cheaply stat the LanceDB `_versions`
+   * directory mtime. If it advanced past the last write WE made, an
+   * external writer touched the store → call `table.checkoutLatest()`
+   * to re-point the handle at the newest version. The mtime gate makes
+   * idle searches free and — critically — prevents the server's OWN
+   * continuous upserts (incremental file-watch indexing) from
+   * triggering a refresh storm: every own write updates
+   * `lastKnownMtime`, so the next read sees no advance.
+   *
+   * `externalRefreshCount` is exposed for tests + telemetry to prove
+   * own-writes don't cause redundant refreshes.
+   */
+  lastKnownMtimeMs = 0;
+  externalRefreshCount = 0;
   constructor(dbPath, options = {}) {
     this.dbPath = dbPath ?? path.join(process.cwd(), ".ctxloom", "vectors.lancedb");
     this.compactEvery = options.compactEvery ?? 200;
@@ -60,6 +81,87 @@ var VectorStore = class {
       await this.table.delete("id = '__seed__'");
     }
     this.initialized = true;
+    this.markSynced();
+  }
+  /**
+   * Absolute path to the LanceDB table's `_versions` manifest directory.
+   * A new manifest file lands here on every committed write, so the
+   * directory's mtime is a cheap external-change signal.
+   */
+  versionsDir() {
+    return path.join(this.dbPath, "code_embeddings.lance", "_versions");
+  }
+  /**
+   * Newest mtime (ms) among the manifest FILES inside `_versions`, or 0
+   * if unreadable. We scan files, NOT the directory itself: LanceDB does
+   * NOT bump the `_versions` directory's own mtime when it adds a new
+   * manifest (verified empirically against @lancedb/lancedb 0.27.x —
+   * the dir mtime stays frozen at creation time), so statting the dir is
+   * a dead signal. Each committed version writes a fresh manifest file,
+   * so max-file-mtime advances monotonically per version and survives
+   * compaction (which writes new manifests with current timestamps).
+   */
+  versionsMtimeMs() {
+    const dir = this.versionsDir();
+    let newest = 0;
+    try {
+      for (const name of fs.readdirSync(dir)) {
+        if (name.startsWith(".")) continue;
+        try {
+          const st = fs.statSync(path.join(dir, name));
+          if (st.isFile() && st.mtimeMs > newest) newest = st.mtimeMs;
+        } catch {
+        }
+      }
+    } catch {
+      return 0;
+    }
+    return newest;
+  }
+  /**
+   * Mark the store as in-sync with the current on-disk state. Called
+   * after init and after every mutation WE perform (upsert, upsertBatch,
+   * remove, compact) so a subsequent refreshIfStale() does not mistake
+   * our own write for an external one.
+   */
+  markSynced() {
+    this.lastKnownMtimeMs = this.versionsMtimeMs();
+  }
+  /**
+   * Re-point the pinned table handle at the newest on-disk version IF an
+   * external writer (a terminal `ctxloom index` on the same path) has
+   * advanced the store since our last write. Cheap mtime gate first; the
+   * LanceDB `checkoutLatest()` call only happens on a real external
+   * change. Best-effort — a failed refresh keeps the current handle and
+   * logs a warning rather than breaking the read.
+   */
+  async refreshIfStale() {
+    if (!this.table) return;
+    const diskMtime = this.versionsMtimeMs();
+    if (diskMtime === 0 || diskMtime <= this.lastKnownMtimeMs) return;
+    try {
+      const table = this.table;
+      if (typeof table.checkoutLatest === "function") {
+        await table.checkoutLatest();
+      }
+      this.lastKnownMtimeMs = this.versionsMtimeMs();
+      this.externalRefreshCount += 1;
+      logger.info("VectorStore: external write detected, handle refreshed", {
+        refreshCount: this.externalRefreshCount
+      });
+    } catch (err) {
+      logger.warn("VectorStore.refreshIfStale failed; keeping current handle", {
+        detail: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  /**
+   * Number of times the pinned handle was refreshed due to an EXTERNAL
+   * write. Exposed for tests (own-writes must not increment this) and
+   * for telemetry. @internal
+   */
+  getExternalRefreshCount() {
+    return this.externalRefreshCount;
   }
   /**
    * Compare the active embedding model against the marker file written
@@ -125,6 +227,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
     this.db = null;
     this.table = null;
     this.initialized = false;
+    this.lastKnownMtimeMs = 0;
   }
   /**
    * Insert or update a code record.
@@ -144,6 +247,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
       content: content.slice(0, 512)
     };
     await this.table.add([record]);
+    this.markSynced();
     this.upsertsSinceCompact++;
     if (this.upsertsSinceCompact >= this.compactEvery) {
       this.upsertsSinceCompact = 0;
@@ -186,6 +290,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
       content: r.content.slice(0, 512)
     }));
     await this.table.add(rows);
+    this.markSynced();
     this.upsertsSinceCompact += records.length;
     if (this.upsertsSinceCompact >= this.compactEvery) {
       this.upsertsSinceCompact = 0;
@@ -216,6 +321,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
           bytesRemoved: result.prune?.bytesRemoved ?? 0
         });
       }
+      this.markSynced();
     } catch (err) {
       logger.warn("VectorStore.compact failed (non-fatal)", {
         detail: err instanceof Error ? err.message : String(err)
@@ -230,6 +336,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
    */
   async findEmbeddingByPath(filePath) {
     if (!this.table) throw new Error("VectorStore not initialized. Call init() first.");
+    await this.refreshIfStale();
     try {
       const safe = sanitizeFilterPath(filePath);
       const rows = await this.table.query().where(`filePath = '${safe}'`).limit(1).toArray();
@@ -256,6 +363,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
    */
   async search(queryEmbedding, limit = 10) {
     if (!this.table) throw new Error("VectorStore not initialized. Call init() first.");
+    await this.refreshIfStale();
     try {
       const results = await this.table.vectorSearch(queryEmbedding).limit(limit).toArray();
       return results.filter((r) => r.id !== "__seed__").map((r) => ({
@@ -286,6 +394,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
     const safe = sanitizeFilterPath(filePath);
     try {
       await this.table.delete(`filePath = '${safe}'`);
+      this.markSynced();
     } catch (err) {
       logger.error("Remove failed", { detail: err instanceof Error ? err.message : String(err) });
     }
@@ -295,6 +404,7 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
    */
   async count() {
     if (!this.table) return 0;
+    await this.refreshIfStale();
     try {
       return await this.table.countRows();
     } catch (err) {
@@ -307,4 +417,4 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
 export {
   VectorStore
 };
-//# sourceMappingURL=chunk-XQEQLXY5.js.map
+//# sourceMappingURL=chunk-Z3NQHCWG.js.map

package/dist/{embedder-4MM7D3UE.js → embedder-E2GDBGOH.js}

@@ -10,7 +10,7 @@ import {
   indexDirectory,
   isIgnoredDir,
   resolveEmbeddingModel
-} from "./chunk-JZOJC3S7.js";
+} from "./chunk-R32CUQAL.js";
 import "./chunk-TYDMSHV7.js";
 export {
   EMBEDDING_DIMENSION,
@@ -25,4 +25,4 @@ export {
   isIgnoredDir,
   resolveEmbeddingModel
 };
-//# sourceMappingURL=embedder-4MM7D3UE.js.map
+//# sourceMappingURL=embedder-E2GDBGOH.js.map

package/dist/index.js

@@ -47,19 +47,19 @@ import {
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-OEDNX3CV.js";
+} from "./chunk-7WLMI4AD.js";
 import {
   addCtxloomToConfig,
   detectInstalledClients
 } from "./chunk-YHLMQVBV.js";
 import {
   VectorStore
-} from "./chunk-XQEQLXY5.js";
+} from "./chunk-Z3NQHCWG.js";
 import {
   collectFiles,
   generateEmbedding,
   indexDirectory
-} from "./chunk-JZOJC3S7.js";
+} from "./chunk-R32CUQAL.js";
 import "./chunk-5I6CJITG.js";
 import {
   logger
@@ -1068,7 +1068,7 @@ try {
 } catch {
 }
 var args = process.argv.slice(2);
-var ctxloomVersion = "1.7.7".length > 0 ? "1.7.7" : "dev";
+var ctxloomVersion = "1.7.8".length > 0 ? "1.7.8" : "dev";
 if (args.includes("--version") || args.includes("-v")) {
   process.stdout.write(`ctxloom ${ctxloomVersion}
 `);
@@ -1163,7 +1163,7 @@ async function checkLicense() {
   if (command !== void 0 && LICENSE_GATE_BYPASS_COMMANDS.has(command)) return;
   const ciKey = process.env["CTXLOOM_LICENSE_KEY"];
   if (ciKey) {
-    const { ApiClient } = await import("./src-HFPCEHYB.js");
+    const { ApiClient } = await import("./src-C5NS2JAW.js");
     const client = new ApiClient(process.env["CTXLOOM_API_BASE"]);
     try {
       const result = await client.validate(ciKey, "ci-ephemeral");
@@ -1556,7 +1556,7 @@ async function main() {
         }
         if (!skipHarness) {
           process.stdout.write("\n");
-          const { installHarness } = await import("./src-HFPCEHYB.js");
+          const { installHarness } = await import("./src-C5NS2JAW.js");
           const h = installHarness({ cwd: initRoot, dryRun, force, extraHosts });
           const harnessFiles = [
             h.claudeMd,
@@ -1619,7 +1619,7 @@ async function main() {
         process.exit(1);
       }
       if (alias !== void 0) {
-        const { validateAlias } = await import("./src-HFPCEHYB.js");
+        const { validateAlias } = await import("./src-C5NS2JAW.js");
         const v = validateAlias(alias);
         if (!v.ok) {
           console.error(`[ctxloom] Invalid alias: ${v.reason}`);
@@ -1978,7 +1978,7 @@ Suggested reviewers for ${files.length} file(s):`);
         process.stderr.write("[ctxloom] --limit must be a non-negative integer (0 for unlimited)\n");
         process.exit(2);
       }
-      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-HFPCEHYB.js");
+      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-C5NS2JAW.js");
       let config;
       try {
         config = await loadRulesConfig(root);
@@ -2002,7 +2002,7 @@ Suggested reviewers for ${files.length} file(s):`);
       }
       let graph;
       if (useSnapshot) {
-        const { DependencyGraph: DG } = await import("./src-HFPCEHYB.js");
+        const { DependencyGraph: DG } = await import("./src-C5NS2JAW.js");
         graph = new DG();
         const loaded = await graph.loadSnapshotOnly(root);
         if (!loaded) {
@@ -2011,7 +2011,7 @@ Suggested reviewers for ${files.length} file(s):`);
         }
       } else {
         process.stderr.write("[ctxloom] Building dependency graph...\n");
-        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-HFPCEHYB.js");
+        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-C5NS2JAW.js");
         let parser;
         try {
           parser = new ASTParser2();

package/dist/{src-HFPCEHYB.js → src-C5NS2JAW.js}

@@ -132,10 +132,10 @@ import {
   wrapBlock,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-OEDNX3CV.js";
+} from "./chunk-7WLMI4AD.js";
 import {
   VectorStore
-} from "./chunk-XQEQLXY5.js";
+} from "./chunk-Z3NQHCWG.js";
 import {
   EMBEDDING_DIMENSION,
   INDEXER_IGNORED_DIRS,
@@ -143,7 +143,7 @@ import {
   generateEmbedding,
   indexDirectory,
   isIgnoredDir
-} from "./chunk-JZOJC3S7.js";
+} from "./chunk-R32CUQAL.js";
 import {
   filenameForDate,
   readEvents,
@@ -304,4 +304,4 @@ export {
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-HFPCEHYB.js.map
+//# sourceMappingURL=src-C5NS2JAW.js.map

package/dist/workers/indexerWorker.js

@@ -1,9 +1,9 @@
 import {
   VectorStore
-} from "../chunk-XQEQLXY5.js";
+} from "../chunk-Z3NQHCWG.js";
 import {
   generateEmbedding
-} from "../chunk-JZOJC3S7.js";
+} from "../chunk-R32CUQAL.js";
 import "../chunk-TYDMSHV7.js";
 
 // packages/core/src/workers/indexerWorker.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxloom-pro",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "description": "ctxloom — The Universal Code Context Engine. A local-first MCP server providing intelligent code context via hybrid Vector + AST + Graph search with Skeletonization (92% token reduction).",
   "type": "module",
   "main": "dist/index.js",

package/dist/VectorStore-5ALWL6XF.js

@@ -1,9 +0,0 @@
-import {
-  VectorStore
-} from "./chunk-XQEQLXY5.js";
-import "./chunk-JZOJC3S7.js";
-import "./chunk-TYDMSHV7.js";
-export {
-  VectorStore
-};
-//# sourceMappingURL=VectorStore-5ALWL6XF.js.map