ctxloom-pro 1.7.2 → 1.7.3

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.1`) 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.3`) 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.1
+      - run: npm install -g ctxloom-pro@1.7.3
       - run: ctxloom index
       - run: ctxloom rules check --json
 ```

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

@@ -2909,7 +2909,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.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION = "1.7.3".length > 0 ? "1.7.3" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -12141,7 +12141,7 @@ function resolveTelemetryLevel() {
 }
 var TELEMETRY_LEVEL = resolveTelemetryLevel();
 var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
-var CTXLOOM_VERSION2 = "1.7.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION2 = "1.7.3".length > 0 ? "1.7.3" : "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" : "");
@@ -12382,12 +12382,17 @@ those instead of guessing.
 | \`ctx_architecture_overview\` | High-level codebase map |
 | \`ctx_refactor_preview\` / \`ctx_apply_refactor\` | Plan a rename |
 
-### Hooks keep the graph fresh
-
-\`ctxloom init\` installed a PostToolUse hook on \`Write|Edit\` that
-runs \`ctxloom update --incremental --quiet\` \u2014 so the graph is
-always up to date when you query it. No "did the index update yet?"
-guessing.`;
+### How the graph stays fresh
+
+The ctxloom MCP server's built-in \`FileWatcher\` (chokidar with 200ms
+debounce) keeps the graph + vectors in sync in real time as you edit
+files \u2014 no manual reindex needed. A belt-and-suspenders PostToolUse
+hook (\`ctxloom update --incremental --quiet\`) is also installed; in
+v1.7.3+ it's a no-op that exits cleanly. In earlier versions the
+\`update\` subcommand silently didn't exist, which made the hook spawn
+orphan MCP servers and accumulate LanceDB fragments \u2014 if you ever see
+\`ctx_search\` stalling for minutes, run \`ctxloom vectors-cleanup\`
+to fix.`;
 var SESSION_START_HEADER = `#!/usr/bin/env bash
 # ctxloom \u2014 agent-harness session-start hook
 # Generated by \`ctxloom init\`. Re-run \`ctxloom init\` to update.

package/dist/{chunk-QL5UJTQL.js → chunk-KQ5CQLIA.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.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION = "1.7.3".length > 0 ? "1.7.3" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -10959,7 +10959,7 @@ var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
 function getTelemetryLevel() {
   return TELEMETRY_LEVEL;
 }
-var CTXLOOM_VERSION2 = "1.7.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION2 = "1.7.3".length > 0 ? "1.7.3" : "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" : "");
@@ -11670,12 +11670,17 @@ those instead of guessing.
 | \`ctx_architecture_overview\` | High-level codebase map |
 | \`ctx_refactor_preview\` / \`ctx_apply_refactor\` | Plan a rename |
 
-### Hooks keep the graph fresh
-
-\`ctxloom init\` installed a PostToolUse hook on \`Write|Edit\` that
-runs \`ctxloom update --incremental --quiet\` \u2014 so the graph is
-always up to date when you query it. No "did the index update yet?"
-guessing.`;
+### How the graph stays fresh
+
+The ctxloom MCP server's built-in \`FileWatcher\` (chokidar with 200ms
+debounce) keeps the graph + vectors in sync in real time as you edit
+files \u2014 no manual reindex needed. A belt-and-suspenders PostToolUse
+hook (\`ctxloom update --incremental --quiet\`) is also installed; in
+v1.7.3+ it's a no-op that exits cleanly. In earlier versions the
+\`update\` subcommand silently didn't exist, which made the hook spawn
+orphan MCP servers and accumulate LanceDB fragments \u2014 if you ever see
+\`ctx_search\` stalling for minutes, run \`ctxloom vectors-cleanup\`
+to fix.`;
 var SESSION_START_HEADER = `#!/usr/bin/env bash
 # ctxloom \u2014 agent-harness session-start hook
 # Generated by \`ctxloom init\`. Re-run \`ctxloom init\` to update.
@@ -12635,4 +12640,4 @@ export {
   skillFilePath,
   installHarness
 };
-//# sourceMappingURL=chunk-QL5UJTQL.js.map
+//# sourceMappingURL=chunk-KQ5CQLIA.js.map

package/dist/index.js

@@ -47,7 +47,7 @@ import {
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-QL5UJTQL.js";
+} from "./chunk-KQ5CQLIA.js";
 import {
   addCtxloomToConfig,
   detectInstalledClients
@@ -56,6 +56,7 @@ import {
   VectorStore
 } from "./chunk-7S2ELKNU.js";
 import {
+  collectFiles,
   generateEmbedding,
   indexDirectory
 } from "./chunk-6FGTNOCP.js";
@@ -435,6 +436,33 @@ async function startServer(opts = {}) {
     }
   } catch {
   }
+  if (PROJECT_ROOT) {
+    try {
+      const fragCounts = inspectVectorsDb(PROJECT_ROOT);
+      const fragTotal = fragCounts.txn + fragCounts.manifest + fragCounts.lance;
+      if (fragTotal > 500) {
+        const sourceFileCount = collectFiles(PROJECT_ROOT).length;
+        const FRAGMENT_RATIO_THRESHOLD = 50;
+        if (sourceFileCount > 0 && fragTotal > sourceFileCount * FRAGMENT_RATIO_THRESHOLD) {
+          const mb = (fragCounts.totalBytes / 1024 / 1024).toFixed(0);
+          logger.warn(
+            "LanceDB fragment count is pathological \u2014 MCP tools may stall for minutes on first call. Run `ctxloom vectors-cleanup` (close other ctxloom MCP servers first) to fix.",
+            {
+              sourceFiles: sourceFileCount,
+              fragments: fragTotal,
+              ratio: Math.round(fragTotal / sourceFileCount),
+              ratioThreshold: FRAGMENT_RATIO_THRESHOLD,
+              sizeMB: Number(mb),
+              txn: fragCounts.txn,
+              manifest: fragCounts.manifest,
+              lance: fragCounts.lance
+            }
+          );
+        }
+      }
+    } catch {
+    }
+  }
   if (!ctx.noDefaultMode) {
     Promise.all([ctx.getGraph(), generateEmbedding("warmup")]).then(async ([graph]) => {
       logger.info("Ready", { edges: graph.edgeCount() });
@@ -1039,7 +1067,7 @@ try {
 } catch {
 }
 var args = process.argv.slice(2);
-var ctxloomVersion = "1.7.2".length > 0 ? "1.7.2" : "dev";
+var ctxloomVersion = "1.7.3".length > 0 ? "1.7.3" : "dev";
 if (args.includes("--version") || args.includes("-v")) {
   process.stdout.write(`ctxloom ${ctxloomVersion}
 `);
@@ -1107,12 +1135,34 @@ function buildActivityFromOverlay(store) {
     lastCommitTimestamp
   }));
 }
-var LICENSE_GATE_BYPASS_COMMANDS = /* @__PURE__ */ new Set(["trial", "activate", "deactivate", "status", "budget-stats", "--help"]);
+var LICENSE_GATE_BYPASS_COMMANDS = /* @__PURE__ */ new Set(["trial", "activate", "deactivate", "status", "budget-stats", "--help", "update"]);
+var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
+  "trial",
+  "activate",
+  "deactivate",
+  "status",
+  "init",
+  "index",
+  "setup",
+  "install-pr-bot",
+  "register",
+  "repos",
+  "grammars",
+  "vectors-cleanup",
+  "budget-stats",
+  "dashboard",
+  "review-suggest",
+  "authors-sync",
+  "rules",
+  "update",
+  "--help",
+  "-h"
+]);
 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-GTPLDFUS.js");
+    const { ApiClient } = await import("./src-Y4TTG5HV.js");
     const client = new ApiClient(process.env["CTXLOOM_API_BASE"]);
     try {
       const result = await client.validate(ciKey, "ci-ephemeral");
@@ -1339,8 +1389,23 @@ async function main() {
   if (command !== void 0 && shouldEmitInstallCompleted()) {
     track("install_completed", { command });
   }
+  if (command !== void 0 && !KNOWN_COMMANDS.has(command)) {
+    process.stderr.write(
+      `${error(`Unknown command: ${style.bold(String(command))}`)}
+
+  Run ${style.highlight("ctxloom --help")} for the list of available commands.
+  To start the MCP server, run ${style.highlight("ctxloom")} with no arguments.
+
+`
+    );
+    process.exit(1);
+  }
   await checkLicense();
   switch (command) {
+    case void 0: {
+      await startServer({ withGit, gitWindowDays });
+      break;
+    }
     case "trial": {
       await runTrial();
       break;
@@ -1490,7 +1555,7 @@ async function main() {
         }
         if (!skipHarness) {
           process.stdout.write("\n");
-          const { installHarness } = await import("./src-GTPLDFUS.js");
+          const { installHarness } = await import("./src-Y4TTG5HV.js");
           const h = installHarness({ cwd: initRoot, dryRun, force, extraHosts });
           const harnessFiles = [
             h.claudeMd,
@@ -1553,7 +1618,7 @@ async function main() {
         process.exit(1);
       }
       if (alias !== void 0) {
-        const { validateAlias } = await import("./src-GTPLDFUS.js");
+        const { validateAlias } = await import("./src-Y4TTG5HV.js");
         const v = validateAlias(alias);
         if (!v.ok) {
           console.error(`[ctxloom] Invalid alias: ${v.reason}`);
@@ -1912,7 +1977,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-GTPLDFUS.js");
+      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-Y4TTG5HV.js");
       let config;
       try {
         config = await loadRulesConfig(root);
@@ -1936,7 +2001,7 @@ Suggested reviewers for ${files.length} file(s):`);
       }
       let graph;
       if (useSnapshot) {
-        const { DependencyGraph: DG } = await import("./src-GTPLDFUS.js");
+        const { DependencyGraph: DG } = await import("./src-Y4TTG5HV.js");
         graph = new DG();
         const loaded = await graph.loadSnapshotOnly(root);
         if (!loaded) {
@@ -1945,7 +2010,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-GTPLDFUS.js");
+        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-Y4TTG5HV.js");
         let parser;
         try {
           parser = new ASTParser2();
@@ -2062,10 +2127,23 @@ Tools Exposed:
 `);
       break;
     }
-    default: {
-      await startServer({ withGit, gitWindowDays });
+    case "update": {
+      const isQuiet = args.includes("--quiet");
+      if (!isQuiet) {
+        process.stdout.write(
+          `${success("ctxloom update: no-op (MCP server FileWatcher handles incremental updates)")}
+`
+        );
+      }
       break;
     }
+    default: {
+      process.stderr.write(
+        `${error(`Internal error: unhandled command '${String(command)}' reached switch default. This indicates KNOWN_COMMANDS and the switch are out of sync.`)}
+`
+      );
+      process.exit(1);
+    }
   }
 }
 main().catch((err) => {

package/dist/{src-GTPLDFUS.js → src-Y4TTG5HV.js}

@@ -132,7 +132,7 @@ import {
   wrapBlock,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-QL5UJTQL.js";
+} from "./chunk-KQ5CQLIA.js";
 import {
   VectorStore
 } from "./chunk-7S2ELKNU.js";
@@ -300,4 +300,4 @@ export {
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-GTPLDFUS.js.map
+//# sourceMappingURL=src-Y4TTG5HV.js.map

package/package.json

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