ctxloom-pro 1.7.4 → 1.7.5

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.4`) 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.5`) 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.4
+      - run: npm install -g ctxloom-pro@1.7.5
       - 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.4".length > 0 ? "1.7.4" : "dev";
+var CTXLOOM_VERSION = "1.7.5".length > 0 ? "1.7.5" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -2986,6 +2986,28 @@ var DependencyGraph = class {
   rootDir = "";
   snapshotDir = "";
   tsPathsResolver = null;
+  /**
+   * fs.watch handle on `.ctxloom/graph-snapshot.json`. When the file is
+   * rewritten externally (e.g. the user runs `ctxloom index` from a
+   * terminal while an MCP server is live), this watcher triggers an
+   * in-memory rehydrate so subsequent tool calls reflect the new graph
+   * without needing the user to restart their MCP client.
+   *
+   * Real repro that motivated this (v1.7.5): EasyMoney user ran
+   * `rm -rf .ctxloom && ctxloom index` from the terminal but the
+   * Claude Desktop MCP server kept serving the pre-wipe in-memory
+   * graph (`Files: 2`) because there was no mechanism to detect the
+   * fresh snapshot on disk. Confusing diagnostic loop.
+   */
+  snapshotWatcher = null;
+  /** Debounce timer for snapshot-change events. */
+  snapshotReloadTimer = null;
+  /**
+   * Tracks the snapshot mtime we last loaded from disk so the watcher
+   * can suppress its own-write echo. saveSnapshot() updates this just
+   * before writing; the watcher ignores any change whose mtime <= this.
+   */
+  lastLoadedSnapshotMtimeMs = 0;
   /**
    * Build the graph from all supported files in rootDir using AST parsing.
    */
@@ -3185,6 +3207,105 @@ var DependencyGraph = class {
     this.snapshotDir = path7.join(rootDir, ".ctxloom");
     return this.loadSnapshot();
   }
+  /**
+   * Start watching `.ctxloom/graph-snapshot.json` for external rewrites.
+   * When the user runs `ctxloom index` (or any other tool) from a
+   * terminal against the same project root, the watcher detects the
+   * new mtime, reloads the snapshot, and atomically swaps the
+   * in-memory graph — so subsequent MCP tool calls see the fresh
+   * graph without requiring an MCP client restart.
+   *
+   * Own writes (via saveSnapshot) update lastLoadedSnapshotMtimeMs
+   * BEFORE the rename completes, so the watcher's own-write echo is
+   * filtered out by the mtime check.
+   *
+   * Debounced 200 ms — matches the FileWatcher cadence and absorbs
+   * the burst of fs.watch events some platforms emit for a single
+   * write (Linux can fire `rename` + `change`, macOS sometimes
+   * fires multiple `change` for atomic rename).
+   *
+   * Idempotent: calling twice is harmless (re-uses the existing
+   * watcher). Call stopSnapshotWatcher() before disposing the graph
+   * to release the FD.
+   */
+  startSnapshotWatcher(debounceMs = 200) {
+    if (this.snapshotWatcher) return;
+    if (!this.snapshotDir) {
+      logger.warn("startSnapshotWatcher: no snapshotDir set, call buildFromDirectory first");
+      return;
+    }
+    const snapshotPath = this.getSnapshotPath();
+    if (!fs7.existsSync(snapshotPath)) {
+      logger.warn("startSnapshotWatcher: snapshot file does not exist yet", { path: snapshotPath });
+      return;
+    }
+    try {
+      this.snapshotWatcher = fs7.watch(snapshotPath, { persistent: false }, (eventType) => {
+        if (this.snapshotReloadTimer) clearTimeout(this.snapshotReloadTimer);
+        this.snapshotReloadTimer = setTimeout(() => {
+          this.snapshotReloadTimer = null;
+          void this.maybeReloadSnapshot(eventType);
+        }, debounceMs);
+      });
+      this.snapshotWatcher.on("error", (err) => {
+        logger.warn("snapshot watcher error", { detail: err instanceof Error ? err.message : String(err) });
+      });
+      logger.info("Graph snapshot hot-reload watcher started", { path: snapshotPath });
+    } catch (err) {
+      logger.warn("startSnapshotWatcher: failed to attach fs.watch", {
+        detail: err instanceof Error ? err.message : String(err)
+      });
+      this.snapshotWatcher = null;
+    }
+  }
+  /**
+   * Stop the snapshot watcher and clear any pending debounce timer.
+   * Call before disposing the graph to release the FD held by fs.watch.
+   * Idempotent.
+   */
+  stopSnapshotWatcher() {
+    if (this.snapshotReloadTimer) {
+      clearTimeout(this.snapshotReloadTimer);
+      this.snapshotReloadTimer = null;
+    }
+    if (this.snapshotWatcher) {
+      try {
+        this.snapshotWatcher.close();
+      } catch {
+      }
+      this.snapshotWatcher = null;
+    }
+  }
+  /**
+   * Internal: called from the debounced watcher. Compares on-disk
+   * mtime against `lastLoadedSnapshotMtimeMs` to filter own-write
+   * echoes, then re-hydrates the in-memory maps from disk via
+   * loadSnapshot(). Atomic from the perspective of MCP tool calls
+   * because Node's event loop ensures loadSnapshot's map assignments
+   * happen in a single tick (no other code interleaves).
+   */
+  async maybeReloadSnapshot(eventType) {
+    const snapshotPath = this.getSnapshotPath();
+    let currentMtime = 0;
+    try {
+      currentMtime = fs7.statSync(snapshotPath).mtimeMs;
+    } catch {
+      return;
+    }
+    if (currentMtime <= this.lastLoadedSnapshotMtimeMs) {
+      return;
+    }
+    const ok = await this.loadSnapshot();
+    if (ok) {
+      logger.info("Graph snapshot hot-reloaded", {
+        event: eventType,
+        files: this.forwardEdges.size,
+        edges: this.edgeCount()
+      });
+    } else {
+      logger.warn("Graph snapshot hot-reload skipped (snapshot invalid or version-stale)");
+    }
+  }
   /**
    * Get files that the given file directly imports.
    */
@@ -3459,6 +3580,10 @@ var DependencyGraph = class {
     const tmpPath = `${snapshotPath}.${process.pid}.tmp`;
     fs7.writeFileSync(tmpPath, JSON.stringify(data, null, 2));
     fs7.renameSync(tmpPath, snapshotPath);
+    try {
+      this.lastLoadedSnapshotMtimeMs = fs7.statSync(snapshotPath).mtimeMs;
+    } catch {
+    }
     const callData = this.callGraphIndex.toJSON();
     const callPath = path7.join(this.snapshotDir, "call-graph-snapshot.json");
     const callTmp = `${callPath}.${process.pid}.tmp`;
@@ -3536,6 +3661,10 @@ var DependencyGraph = class {
           this.callGraphIndex = new CallGraphIndex();
         }
       }
+      try {
+        this.lastLoadedSnapshotMtimeMs = fs7.statSync(snapshotPath).mtimeMs;
+      } catch {
+      }
       return true;
     } catch (err) {
       logger.error("Failed to load graph snapshot, will rebuild", { detail: err instanceof Error ? err.message : String(err) });
@@ -12161,7 +12290,7 @@ function resolveTelemetryLevel() {
 }
 var TELEMETRY_LEVEL = resolveTelemetryLevel();
 var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
-var CTXLOOM_VERSION2 = "1.7.4".length > 0 ? "1.7.4" : "dev";
+var CTXLOOM_VERSION2 = "1.7.5".length > 0 ? "1.7.5" : "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/{chunk-AF76TJPL.js → chunk-2YELCPTS.js}

@@ -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.4".length > 0 ? "1.7.4" : "dev";
+var CTXLOOM_VERSION = "1.7.5".length > 0 ? "1.7.5" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -2762,6 +2762,28 @@ var DependencyGraph = class {
   rootDir = "";
   snapshotDir = "";
   tsPathsResolver = null;
+  /**
+   * fs.watch handle on `.ctxloom/graph-snapshot.json`. When the file is
+   * rewritten externally (e.g. the user runs `ctxloom index` from a
+   * terminal while an MCP server is live), this watcher triggers an
+   * in-memory rehydrate so subsequent tool calls reflect the new graph
+   * without needing the user to restart their MCP client.
+   *
+   * Real repro that motivated this (v1.7.5): EasyMoney user ran
+   * `rm -rf .ctxloom && ctxloom index` from the terminal but the
+   * Claude Desktop MCP server kept serving the pre-wipe in-memory
+   * graph (`Files: 2`) because there was no mechanism to detect the
+   * fresh snapshot on disk. Confusing diagnostic loop.
+   */
+  snapshotWatcher = null;
+  /** Debounce timer for snapshot-change events. */
+  snapshotReloadTimer = null;
+  /**
+   * Tracks the snapshot mtime we last loaded from disk so the watcher
+   * can suppress its own-write echo. saveSnapshot() updates this just
+   * before writing; the watcher ignores any change whose mtime <= this.
+   */
+  lastLoadedSnapshotMtimeMs = 0;
   /**
    * Build the graph from all supported files in rootDir using AST parsing.
    */
@@ -2961,6 +2983,105 @@ var DependencyGraph = class {
     this.snapshotDir = path6.join(rootDir, ".ctxloom");
     return this.loadSnapshot();
   }
+  /**
+   * Start watching `.ctxloom/graph-snapshot.json` for external rewrites.
+   * When the user runs `ctxloom index` (or any other tool) from a
+   * terminal against the same project root, the watcher detects the
+   * new mtime, reloads the snapshot, and atomically swaps the
+   * in-memory graph — so subsequent MCP tool calls see the fresh
+   * graph without requiring an MCP client restart.
+   *
+   * Own writes (via saveSnapshot) update lastLoadedSnapshotMtimeMs
+   * BEFORE the rename completes, so the watcher's own-write echo is
+   * filtered out by the mtime check.
+   *
+   * Debounced 200 ms — matches the FileWatcher cadence and absorbs
+   * the burst of fs.watch events some platforms emit for a single
+   * write (Linux can fire `rename` + `change`, macOS sometimes
+   * fires multiple `change` for atomic rename).
+   *
+   * Idempotent: calling twice is harmless (re-uses the existing
+   * watcher). Call stopSnapshotWatcher() before disposing the graph
+   * to release the FD.
+   */
+  startSnapshotWatcher(debounceMs = 200) {
+    if (this.snapshotWatcher) return;
+    if (!this.snapshotDir) {
+      logger.warn("startSnapshotWatcher: no snapshotDir set, call buildFromDirectory first");
+      return;
+    }
+    const snapshotPath = this.getSnapshotPath();
+    if (!fs6.existsSync(snapshotPath)) {
+      logger.warn("startSnapshotWatcher: snapshot file does not exist yet", { path: snapshotPath });
+      return;
+    }
+    try {
+      this.snapshotWatcher = fs6.watch(snapshotPath, { persistent: false }, (eventType) => {
+        if (this.snapshotReloadTimer) clearTimeout(this.snapshotReloadTimer);
+        this.snapshotReloadTimer = setTimeout(() => {
+          this.snapshotReloadTimer = null;
+          void this.maybeReloadSnapshot(eventType);
+        }, debounceMs);
+      });
+      this.snapshotWatcher.on("error", (err) => {
+        logger.warn("snapshot watcher error", { detail: err instanceof Error ? err.message : String(err) });
+      });
+      logger.info("Graph snapshot hot-reload watcher started", { path: snapshotPath });
+    } catch (err) {
+      logger.warn("startSnapshotWatcher: failed to attach fs.watch", {
+        detail: err instanceof Error ? err.message : String(err)
+      });
+      this.snapshotWatcher = null;
+    }
+  }
+  /**
+   * Stop the snapshot watcher and clear any pending debounce timer.
+   * Call before disposing the graph to release the FD held by fs.watch.
+   * Idempotent.
+   */
+  stopSnapshotWatcher() {
+    if (this.snapshotReloadTimer) {
+      clearTimeout(this.snapshotReloadTimer);
+      this.snapshotReloadTimer = null;
+    }
+    if (this.snapshotWatcher) {
+      try {
+        this.snapshotWatcher.close();
+      } catch {
+      }
+      this.snapshotWatcher = null;
+    }
+  }
+  /**
+   * Internal: called from the debounced watcher. Compares on-disk
+   * mtime against `lastLoadedSnapshotMtimeMs` to filter own-write
+   * echoes, then re-hydrates the in-memory maps from disk via
+   * loadSnapshot(). Atomic from the perspective of MCP tool calls
+   * because Node's event loop ensures loadSnapshot's map assignments
+   * happen in a single tick (no other code interleaves).
+   */
+  async maybeReloadSnapshot(eventType) {
+    const snapshotPath = this.getSnapshotPath();
+    let currentMtime = 0;
+    try {
+      currentMtime = fs6.statSync(snapshotPath).mtimeMs;
+    } catch {
+      return;
+    }
+    if (currentMtime <= this.lastLoadedSnapshotMtimeMs) {
+      return;
+    }
+    const ok = await this.loadSnapshot();
+    if (ok) {
+      logger.info("Graph snapshot hot-reloaded", {
+        event: eventType,
+        files: this.forwardEdges.size,
+        edges: this.edgeCount()
+      });
+    } else {
+      logger.warn("Graph snapshot hot-reload skipped (snapshot invalid or version-stale)");
+    }
+  }
   /**
    * Get files that the given file directly imports.
    */
@@ -3235,6 +3356,10 @@ var DependencyGraph = class {
     const tmpPath = `${snapshotPath}.${process.pid}.tmp`;
     fs6.writeFileSync(tmpPath, JSON.stringify(data, null, 2));
     fs6.renameSync(tmpPath, snapshotPath);
+    try {
+      this.lastLoadedSnapshotMtimeMs = fs6.statSync(snapshotPath).mtimeMs;
+    } catch {
+    }
     const callData = this.callGraphIndex.toJSON();
     const callPath = path6.join(this.snapshotDir, "call-graph-snapshot.json");
     const callTmp = `${callPath}.${process.pid}.tmp`;
@@ -3312,6 +3437,10 @@ var DependencyGraph = class {
           this.callGraphIndex = new CallGraphIndex();
         }
       }
+      try {
+        this.lastLoadedSnapshotMtimeMs = fs6.statSync(snapshotPath).mtimeMs;
+      } catch {
+      }
       return true;
     } catch (err) {
       logger.error("Failed to load graph snapshot, will rebuild", { detail: err instanceof Error ? err.message : String(err) });
@@ -10959,7 +11088,7 @@ var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
 function getTelemetryLevel() {
   return TELEMETRY_LEVEL;
 }
-var CTXLOOM_VERSION2 = "1.7.4".length > 0 ? "1.7.4" : "dev";
+var CTXLOOM_VERSION2 = "1.7.5".length > 0 ? "1.7.5" : "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" : "");
@@ -11294,6 +11423,11 @@ async function disposeProjectState(state) {
     await state.watcher?.stop();
   } catch {
   }
+  try {
+    const graph = state.graphPromise ? await state.graphPromise.catch(() => null) : null;
+    graph?.stopSnapshotWatcher();
+  } catch {
+  }
   try {
     const store = state.storePromise ? await state.storePromise : null;
     await store?.close();
@@ -12640,4 +12774,4 @@ export {
   skillFilePath,
   installHarness
 };
-//# sourceMappingURL=chunk-AF76TJPL.js.map
+//# sourceMappingURL=chunk-2YELCPTS.js.map

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-AF76TJPL.js";
+} from "./chunk-2YELCPTS.js";
 import {
   addCtxloomToConfig,
   detectInstalledClients
@@ -127,6 +127,7 @@ async function initGraph(state) {
         const graph = new DependencyGraph();
         graph.setParser(parser);
         await graph.buildFromDirectory(state.projectRoot);
+        graph.startSnapshotWatcher();
         state.graphInitialized = true;
         return graph;
       } catch (err) {
@@ -1067,7 +1068,7 @@ try {
 } catch {
 }
 var args = process.argv.slice(2);
-var ctxloomVersion = "1.7.4".length > 0 ? "1.7.4" : "dev";
+var ctxloomVersion = "1.7.5".length > 0 ? "1.7.5" : "dev";
 if (args.includes("--version") || args.includes("-v")) {
   process.stdout.write(`ctxloom ${ctxloomVersion}
 `);
@@ -1162,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-ZUDJHQ3T.js");
+    const { ApiClient } = await import("./src-NCWA7NVW.js");
     const client = new ApiClient(process.env["CTXLOOM_API_BASE"]);
     try {
       const result = await client.validate(ciKey, "ci-ephemeral");
@@ -1555,7 +1556,7 @@ async function main() {
         }
         if (!skipHarness) {
           process.stdout.write("\n");
-          const { installHarness } = await import("./src-ZUDJHQ3T.js");
+          const { installHarness } = await import("./src-NCWA7NVW.js");
           const h = installHarness({ cwd: initRoot, dryRun, force, extraHosts });
           const harnessFiles = [
             h.claudeMd,
@@ -1618,7 +1619,7 @@ async function main() {
         process.exit(1);
       }
       if (alias !== void 0) {
-        const { validateAlias } = await import("./src-ZUDJHQ3T.js");
+        const { validateAlias } = await import("./src-NCWA7NVW.js");
         const v = validateAlias(alias);
         if (!v.ok) {
           console.error(`[ctxloom] Invalid alias: ${v.reason}`);
@@ -1977,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-ZUDJHQ3T.js");
+      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-NCWA7NVW.js");
       let config;
       try {
         config = await loadRulesConfig(root);
@@ -2001,7 +2002,7 @@ Suggested reviewers for ${files.length} file(s):`);
       }
       let graph;
       if (useSnapshot) {
-        const { DependencyGraph: DG } = await import("./src-ZUDJHQ3T.js");
+        const { DependencyGraph: DG } = await import("./src-NCWA7NVW.js");
         graph = new DG();
         const loaded = await graph.loadSnapshotOnly(root);
         if (!loaded) {
@@ -2010,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-ZUDJHQ3T.js");
+        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-NCWA7NVW.js");
         let parser;
         try {
           parser = new ASTParser2();

package/dist/{src-ZUDJHQ3T.js → src-NCWA7NVW.js}

@@ -132,7 +132,7 @@ import {
   wrapBlock,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-AF76TJPL.js";
+} from "./chunk-2YELCPTS.js";
 import {
   VectorStore
 } from "./chunk-XQEQLXY5.js";
@@ -304,4 +304,4 @@ export {
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-ZUDJHQ3T.js.map
+//# sourceMappingURL=src-NCWA7NVW.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxloom-pro",
-  "version": "1.7.4",
+  "version": "1.7.5",
   "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",