ctxloom-pro 1.7.4 → 1.7.6

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.6`) 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.6
       - 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.6".length > 0 ? "1.7.6" : "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,118 @@ 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)");
+    }
+  }
+  /**
+   * Absolute root directory this graph was built/loaded against.
+   *
+   * Tools that read file CONTENTS off disk (full-text scan, refactor
+   * preview/apply) must join relpaths against THIS root, not against a
+   * server-level default like ctx.projectRoot — otherwise a call that
+   * passes an explicit project_root different from the default reads
+   * from the wrong directory and silently finds nothing. Returns '' if
+   * the graph was never built (defensive; callers should have a graph).
+   */
+  getRootDir() {
+    return this.rootDir;
+  }
   /**
    * Get files that the given file directly imports.
    */
@@ -3459,6 +3593,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 +3674,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 +12303,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.6".length > 0 ? "1.7.6" : "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-ISXDIRSN.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.6".length > 0 ? "1.7.6" : "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,118 @@ 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)");
+    }
+  }
+  /**
+   * Absolute root directory this graph was built/loaded against.
+   *
+   * Tools that read file CONTENTS off disk (full-text scan, refactor
+   * preview/apply) must join relpaths against THIS root, not against a
+   * server-level default like ctx.projectRoot — otherwise a call that
+   * passes an explicit project_root different from the default reads
+   * from the wrong directory and silently finds nothing. Returns '' if
+   * the graph was never built (defensive; callers should have a graph).
+   */
+  getRootDir() {
+    return this.rootDir;
+  }
   /**
    * Get files that the given file directly imports.
    */
@@ -3235,6 +3369,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 +3450,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) });
@@ -6242,10 +6384,11 @@ function registerContextPacketTool(registry, ctx) {
       const primaryContent = pathValidator.readFile(parsed.target_file);
       const imports = graph.getImports(parsed.target_file);
       const importers = graph.getImporters(parsed.target_file);
+      const rootDir = graph.getRootDir() || ctx.projectRoot;
       const skeletons = await Promise.all(
         imports.map(async (dep) => {
           try {
-            const absDep = path15.resolve(ctx.projectRoot, dep);
+            const absDep = path15.resolve(rootDir, dep);
             const sk = await skeletonizer.skeletonize(absDep);
             return `
 <!-- ${dep} -->
@@ -6896,15 +7039,16 @@ function registerBlastRadiusTool(registry, ctx) {
     },
     async (args) => {
       const { changed_files, depth, use_git, detail_level, project_root } = Schema8.parse(args);
+      const graph = await ctx.getGraph(project_root);
+      const gitRoot = graph.getRootDir() || ctx.projectRoot;
       let files = changed_files ?? [];
       if (files.length === 0 && use_git) {
-        files = await detectChangedFiles(ctx.projectRoot);
+        files = await detectChangedFiles(gitRoot);
       }
       if (files.length === 0) {
         return '<blast_radius changed_files="0">\n  <!-- No changed files detected -->\n</blast_radius>';
       }
-      const graph = await ctx.getGraph(project_root);
-      const result = await computeBlastRadius({ changedFiles: files, depth, projectRoot: ctx.projectRoot, graph });
+      const result = await computeBlastRadius({ changedFiles: files, depth, projectRoot: gitRoot, graph });
       const report = getImpactRadius({ graph, overlay: ctx.overlay, changedFiles: files, depth });
       return buildBlastRadiusXml(result, depth, detail_level, report.historicalCoupling);
     }
@@ -7687,10 +7831,10 @@ async function getFileDiff(projectRoot, file) {
     return "";
   }
 }
-async function trySkeletonize(ctx, filePath, projectRoot) {
+async function trySkeletonize(ctx, filePath, projectRoot, rootDir) {
   try {
     const sk = await ctx.getSkeletonizer(projectRoot);
-    const absPath = `${ctx.projectRoot}/${filePath}`;
+    const absPath = `${rootDir}/${filePath}`;
     return await sk.skeletonize(absPath);
   } catch {
     return "";
@@ -7727,13 +7871,15 @@ function registerGitDiffReviewTool(registry, ctx) {
     async (args) => {
       const { changed_files, depth, use_git, include_skeletons, max_diff_lines, project_root } = Schema17.parse(args);
       const validator = ctx.getPathValidator(project_root);
+      const graph = await ctx.getGraph(project_root);
+      const gitRoot = graph.getRootDir() || ctx.projectRoot;
       let files = (changed_files ?? []).filter((f) => validator.isWithinRoot(f));
       if (files.length === 0 && use_git) {
         try {
           const { stdout } = await execFileAsync(
             "git",
             ["diff", "HEAD~1", "--name-only"],
-            { cwd: ctx.projectRoot, maxBuffer: 10 * 1024 * 1024 }
+            { cwd: gitRoot, maxBuffer: 10 * 1024 * 1024 }
           );
           files = stdout.trim().split("\n").filter(Boolean);
         } catch {
@@ -7757,26 +7903,25 @@ function registerGitDiffReviewTool(registry, ctx) {
   <!-- No changed files detected -->
 </git_diff_review>`);
       }
-      const graph = await ctx.getGraph(project_root);
       const blast = await computeBlastRadius({
         changedFiles: files,
         depth,
-        projectRoot: ctx.projectRoot,
+        projectRoot: gitRoot,
         graph
       });
       const changedFileData = await Promise.all(files.map(async (file) => {
-        const rawDiff = use_git ? await getFileDiff(ctx.projectRoot, file) : "";
+        const rawDiff = use_git ? await getFileDiff(gitRoot, file) : "";
         const diffLines = rawDiff ? rawDiff.split("\n") : [];
         const truncated = diffLines.length > max_diff_lines;
         const diffContent = truncated ? [...diffLines.slice(0, max_diff_lines), `... (${diffLines.length - max_diff_lines} more lines)`].join("\n") : rawDiff;
-        const skeleton = include_skeletons ? await trySkeletonize(ctx, file, project_root) : "";
+        const skeleton = include_skeletons ? await trySkeletonize(ctx, file, project_root, gitRoot) : "";
         return { file, diffLines, truncated, diffContent, skeleton };
       }));
       const skeletonLimit = 5;
       const directImporterSkeletons = await Promise.all(
         blast.directImporters.map(async (file, i) => ({
           file,
-          skeleton: include_skeletons && i < skeletonLimit ? await trySkeletonize(ctx, file, project_root) : ""
+          skeleton: include_skeletons && i < skeletonLimit ? await trySkeletonize(ctx, file, project_root, gitRoot) : ""
         }))
       );
       const render2 = (withSkeletons, withTransitive) => {
@@ -7920,8 +8065,9 @@ function registerRefactorPreviewTool(registry, ctx) {
       const candidates = Array.from(candidateSet).slice(0, max_files);
       const fileChanges = [];
       let totalOccurrences = 0;
+      const rootDir = graph.getRootDir() || ctx.projectRoot;
       for (const relPath of candidates) {
-        const absPath = path18.join(ctx.projectRoot, relPath);
+        const absPath = path18.join(rootDir, relPath);
         const occurrences = scanFile(absPath, symbol, new_name);
         if (occurrences.length > 0) {
           fileChanges.push({ filePath: relPath, occurrences });
@@ -8438,8 +8584,9 @@ function registerApplyRefactorTool(registry, ctx) {
       const candidates = Array.from(candidateSet).slice(0, max_files);
       const results = [];
       let totalOccurrences = 0;
+      const rootDir = graph.getRootDir() || ctx.projectRoot;
       for (const relPath of candidates) {
-        const absPath = path20.join(ctx.projectRoot, relPath);
+        const absPath = path20.join(rootDir, relPath);
         const count = applyToFile(absPath, symbol, new_name, dry_run);
         if (count > 0) {
           results.push({ filePath: relPath, occurrences: count, written: !dry_run });
@@ -8530,14 +8677,15 @@ function registerDetectChangesTool(registry, ctx) {
     },
     async (args) => {
       const { changed_files, use_git, detail_level, project_root } = Schema22.parse(args);
+      const graph = await ctx.getGraph(project_root);
+      const gitRoot = graph.getRootDir() || ctx.projectRoot;
       let files = changed_files ?? [];
       if (files.length === 0 && use_git) {
-        files = await detectChangedFiles2(ctx.projectRoot);
+        files = await detectChangedFiles2(gitRoot);
       }
       if (files.length === 0) {
         return '<detect_changes count="0">\n  <!-- No changed files detected -->\n</detect_changes>';
       }
-      const graph = await ctx.getGraph(project_root);
       const { changedFiles: scored, summary } = detectChanges({
         graph,
         overlay: ctx.overlay,
@@ -8707,9 +8855,10 @@ function registerFullTextSearchTool(registry, ctx) {
       }
       const graph = await ctx.getGraph(project_root);
       const files = graph.allFiles();
+      const rootDir = graph.getRootDir() || ctx.projectRoot;
       const keywordResults = [];
       for (const relPath of files) {
-        const absPath = path21.join(ctx.projectRoot, relPath);
+        const absPath = path21.join(rootDir, relPath);
         const hit = scanFile2(absPath, pattern, context_lines);
         if (hit) {
           keywordResults.push({
@@ -8810,14 +8959,15 @@ function registerSuggestedQuestionsTool(registry, ctx) {
     },
     async (args) => {
       const { changed_files, use_git, project_root } = Schema24.parse(args);
+      const graph = await ctx.getGraph(project_root);
+      const gitRoot = graph.getRootDir() || ctx.projectRoot;
       let files = changed_files ?? [];
       if (files.length === 0 && use_git) {
-        files = await detectChangedFiles3(ctx.projectRoot);
+        files = await detectChangedFiles3(gitRoot);
       }
       if (files.length === 0) {
         return '<suggested_questions count="1" changed_files="0"><question>No changed files detected. Are you on a git branch with commits?</question></suggested_questions>';
       }
-      const graph = await ctx.getGraph(project_root);
       const questions = [];
       const allImporters = /* @__PURE__ */ new Set();
       const hubFiles = [];
@@ -9727,14 +9877,15 @@ function registerGetAffectedFlowsTool(registry, ctx) {
     },
     async (args) => {
       const { changed_files, use_git, depth, max_flows, max_steps_per_flow, project_root } = Schema29.parse(args);
+      const graph = await ctx.getGraph(project_root);
+      const gitRoot = graph.getRootDir() || ctx.projectRoot;
       let files = changed_files ?? [];
       if (files.length === 0 && use_git) {
-        files = await detectChangedFiles4(ctx.projectRoot);
+        files = await detectChangedFiles4(gitRoot);
       }
       if (files.length === 0) {
         return '<affected_flows changed_files="0" total_flows="0">\n  <!-- No changed files detected -->\n</affected_flows>';
       }
-      const graph = await ctx.getGraph(project_root);
       const callIdx = graph.getCallGraphIndex();
       const changedSymbols = [];
       for (const file of files) {
@@ -10959,7 +11110,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.6".length > 0 ? "1.7.6" : "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 +11445,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 +12796,4 @@ export {
   skillFilePath,
   installHarness
 };
-//# sourceMappingURL=chunk-AF76TJPL.js.map
+//# sourceMappingURL=chunk-ISXDIRSN.js.map

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-AF76TJPL.js";
+} from "./chunk-ISXDIRSN.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.6".length > 0 ? "1.7.6" : "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-FB2SJJZR.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-FB2SJJZR.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-FB2SJJZR.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-FB2SJJZR.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-FB2SJJZR.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-FB2SJJZR.js");
         let parser;
         try {
           parser = new ASTParser2();

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

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

package/package.json

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