ctxloom-pro 1.7.2 → 1.7.4

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.4`) 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.4
       - run: ctxloom index
       - run: ctxloom rules check --json
 ```

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

@@ -101,71 +101,28 @@ function resolveEmbeddingModel(env = process.env) {
   };
 }
 function collectFiles(dir, results = []) {
-  const IGNORED_DIRS = /* @__PURE__ */ new Set([
-    // Build artifacts + dependency caches
-    "node_modules",
-    "dist",
-    "build",
-    "out",
-    "target",
-    "coverage",
-    ".cache",
-    ".turbo",
-    ".next",
-    ".nuxt",
-    // Version control + ctxloom state
-    ".git",
-    ".ctxloom",
-    // Other tools' working state (often contains duplicated source)
-    ".claude",
-    ".code-review-graph",
-    ".vscode-test"
-  ]);
-  const SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
-    ".ts",
-    ".tsx",
-    ".js",
-    ".jsx",
-    ".mjs",
-    ".vue",
-    ".py",
-    ".rs",
-    ".go",
-    ".java",
-    ".cs",
-    ".rb",
-    ".kt",
-    ".kts",
-    ".swift",
-    ".php",
-    ".dart",
-    ".c",
-    ".cpp",
-    ".h",
-    ".md",
-    ".json",
-    ".yaml",
-    ".yml",
-    ".toml",
-    ".ipynb"
-  ]);
   const entries = fs3.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path3.join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (!IGNORED_DIRS.has(entry.name)) {
+      if (!isIgnoredDir(entry.name)) {
         collectFiles(fullPath, results);
       }
     } else if (entry.isFile()) {
       const ext = path3.extname(entry.name);
-      if (SUPPORTED_EXTENSIONS.has(ext)) {
+      if (INDEX_SUPPORTED_EXTENSIONS.has(ext)) {
         results.push(fullPath);
       }
     }
   }
   return results;
 }
-var MODEL_REGISTRY, ACTIVE_MODEL, EMBEDDING_DIMENSION, MODEL_ID, MIN_MODEL_BYTES;
+function isIgnoredDir(name) {
+  if (INDEXER_IGNORED_DIRS.has(name)) return true;
+  if (name.endsWith(".egg-info") || name.endsWith(".dist-info")) return true;
+  return false;
+}
+var MODEL_REGISTRY, ACTIVE_MODEL, EMBEDDING_DIMENSION, MODEL_ID, MIN_MODEL_BYTES, INDEXER_IGNORED_DIRS, INDEX_SUPPORTED_EXTENSIONS;
 var init_embedder = __esm({
   "../../packages/core/src/indexer/embedder.ts"() {
     "use strict";
@@ -196,6 +153,69 @@ var init_embedder = __esm({
     EMBEDDING_DIMENSION = ACTIVE_MODEL.dim;
     MODEL_ID = ACTIVE_MODEL.hfId;
     MIN_MODEL_BYTES = ACTIVE_MODEL.minBytes;
+    INDEXER_IGNORED_DIRS = /* @__PURE__ */ new Set([
+      // Build artifacts + dependency caches (JS/TS, Rust, Java)
+      "node_modules",
+      "dist",
+      "build",
+      "out",
+      "target",
+      "coverage",
+      ".cache",
+      ".turbo",
+      ".next",
+      ".nuxt",
+      // Python virtualenvs + caches. Real-world repro: EasyMoney (a 63-
+      // source-file FastAPI project) had a `.venv/` with 8,192 installed-
+      // package files. Pre-fix, `ctxloom index` reported 8,120 files /
+      // 14,138 edges instead of the expected 63 / 97, because none of the
+      // standard Python virtualenv/cache directory names were in this set.
+      // The `__pycache__` + `.pytest_cache` + `.ruff_cache` + `.mypy_cache`
+      // additions catch the bulk of Python noise on top of the venv.
+      ".venv",
+      "venv",
+      "env",
+      "__pycache__",
+      ".pytest_cache",
+      ".ruff_cache",
+      ".mypy_cache",
+      ".tox",
+      // Version control + ctxloom state
+      ".git",
+      ".ctxloom",
+      // Other tools' working state (often contains duplicated source)
+      ".claude",
+      ".code-review-graph",
+      ".vscode-test"
+    ]);
+    INDEX_SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
+      ".ts",
+      ".tsx",
+      ".js",
+      ".jsx",
+      ".mjs",
+      ".vue",
+      ".py",
+      ".rs",
+      ".go",
+      ".java",
+      ".cs",
+      ".rb",
+      ".kt",
+      ".kts",
+      ".swift",
+      ".php",
+      ".dart",
+      ".c",
+      ".cpp",
+      ".h",
+      ".md",
+      ".json",
+      ".yaml",
+      ".yml",
+      ".toml",
+      ".ipynb"
+    ]);
   }
 });
 
@@ -2909,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.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION = "1.7.4".length > 0 ? "1.7.4" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -12141,7 +12161,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.4".length > 0 ? "1.7.4" : "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 +12402,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/VectorStore-5ALWL6XF.js

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

package/dist/{chunk-QL5UJTQL.js → chunk-AF76TJPL.js}

@@ -1,11 +1,11 @@
 import {
   VectorStore
-} from "./chunk-7S2ELKNU.js";
+} from "./chunk-XQEQLXY5.js";
 import {
-  INDEXER_IGNORED_DIRS,
   collectFiles,
-  generateEmbedding
-} from "./chunk-6FGTNOCP.js";
+  generateEmbedding,
+  isIgnoredDir
+} from "./chunk-JZOJC3S7.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.2".length > 0 ? "1.7.2" : "dev";
+var CTXLOOM_VERSION = "1.7.4".length > 0 ? "1.7.4" : "dev";
 var SNAPSHOT_SCHEMA_VERSION = 2;
 function compareCtxloomVersions(snapshotVer, currentVer) {
   if (snapshotVer === currentVer) return "same";
@@ -8687,7 +8687,7 @@ function registerFullTextSearchTool(registry, ctx) {
       };
       if (mode === "semantic") {
         try {
-          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-2JWDJUE2.js");
+          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-4MM7D3UE.js");
           const store = await ctx.getStore(project_root);
           const embedding = await generateEmbedding2(query);
           const results = await store.search(embedding, limit);
@@ -8724,7 +8724,7 @@ function registerFullTextSearchTool(registry, ctx) {
       let merged = keywordResults.slice(0, limit);
       if (mode === "hybrid") {
         try {
-          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-2JWDJUE2.js");
+          const { generateEmbedding: generateEmbedding2 } = await import("./embedder-4MM7D3UE.js");
           const store = await ctx.getStore(project_root);
           const embedding = await generateEmbedding2(query);
           const vectorResults = await store.search(embedding, Math.ceil(limit / 2));
@@ -10599,7 +10599,7 @@ import chokidar from "chokidar";
 function isIgnoredPath(absPath) {
   const segments = absPath.split(/[\\/]/);
   for (const seg of segments) {
-    if (INDEXER_IGNORED_DIRS.has(seg)) return true;
+    if (isIgnoredDir(seg)) return true;
   }
   return false;
 }
@@ -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.4".length > 0 ? "1.7.4" : "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-AF76TJPL.js.map

package/dist/{chunk-6FGTNOCP.js → chunk-JZOJC3S7.js}

@@ -153,64 +153,16 @@ async function generateEmbeddingBatch(texts) {
   return data;
 }
 function collectFiles(dir, results = []) {
-  const IGNORED_DIRS = /* @__PURE__ */ new Set([
-    // Build artifacts + dependency caches
-    "node_modules",
-    "dist",
-    "build",
-    "out",
-    "target",
-    "coverage",
-    ".cache",
-    ".turbo",
-    ".next",
-    ".nuxt",
-    // Version control + ctxloom state
-    ".git",
-    ".ctxloom",
-    // Other tools' working state (often contains duplicated source)
-    ".claude",
-    ".code-review-graph",
-    ".vscode-test"
-  ]);
-  const SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
-    ".ts",
-    ".tsx",
-    ".js",
-    ".jsx",
-    ".mjs",
-    ".vue",
-    ".py",
-    ".rs",
-    ".go",
-    ".java",
-    ".cs",
-    ".rb",
-    ".kt",
-    ".kts",
-    ".swift",
-    ".php",
-    ".dart",
-    ".c",
-    ".cpp",
-    ".h",
-    ".md",
-    ".json",
-    ".yaml",
-    ".yml",
-    ".toml",
-    ".ipynb"
-  ]);
   const entries = fs.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
     const fullPath = path.join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (!IGNORED_DIRS.has(entry.name)) {
+      if (!isIgnoredDir(entry.name)) {
         collectFiles(fullPath, results);
       }
     } else if (entry.isFile()) {
       const ext = path.extname(entry.name);
-      if (SUPPORTED_EXTENSIONS.has(ext)) {
+      if (INDEX_SUPPORTED_EXTENSIONS.has(ext)) {
         results.push(fullPath);
       }
     }
@@ -222,7 +174,7 @@ async function* collectFilesStream(dir) {
   for (const entry of entries) {
     const fullPath = path.join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (!INDEX_IGNORED_DIRS.has(entry.name)) {
+      if (!isIgnoredDir(entry.name)) {
         yield* collectFilesStream(fullPath);
       }
     } else if (entry.isFile()) {
@@ -233,7 +185,7 @@ async function* collectFilesStream(dir) {
   }
 }
 var INDEXER_IGNORED_DIRS = /* @__PURE__ */ new Set([
-  // Build artifacts + dependency caches
+  // Build artifacts + dependency caches (JS/TS, Rust, Java)
   "node_modules",
   "dist",
   "build",
@@ -244,6 +196,21 @@ var INDEXER_IGNORED_DIRS = /* @__PURE__ */ new Set([
   ".turbo",
   ".next",
   ".nuxt",
+  // Python virtualenvs + caches. Real-world repro: EasyMoney (a 63-
+  // source-file FastAPI project) had a `.venv/` with 8,192 installed-
+  // package files. Pre-fix, `ctxloom index` reported 8,120 files /
+  // 14,138 edges instead of the expected 63 / 97, because none of the
+  // standard Python virtualenv/cache directory names were in this set.
+  // The `__pycache__` + `.pytest_cache` + `.ruff_cache` + `.mypy_cache`
+  // additions catch the bulk of Python noise on top of the venv.
+  ".venv",
+  "venv",
+  "env",
+  "__pycache__",
+  ".pytest_cache",
+  ".ruff_cache",
+  ".mypy_cache",
+  ".tox",
   // Version control + ctxloom state
   ".git",
   ".ctxloom",
@@ -252,7 +219,11 @@ var INDEXER_IGNORED_DIRS = /* @__PURE__ */ new Set([
   ".code-review-graph",
   ".vscode-test"
 ]);
-var INDEX_IGNORED_DIRS = INDEXER_IGNORED_DIRS;
+function isIgnoredDir(name) {
+  if (INDEXER_IGNORED_DIRS.has(name)) return true;
+  if (name.endsWith(".egg-info") || name.endsWith(".dist-info")) return true;
+  return false;
+}
 var INDEX_SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx",
@@ -282,7 +253,7 @@ var INDEX_SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ipynb"
 ]);
 async function indexDirectory(rootDir, onProgress) {
-  const { VectorStore } = await import("./VectorStore-WDL3H7QT.js");
+  const { VectorStore } = await import("./VectorStore-5ALWL6XF.js");
   const store = new VectorStore(path.join(rootDir, ".ctxloom", "vectors.lancedb"));
   await store.init();
   let indexed = 0;
@@ -390,8 +361,9 @@ export {
   collectFiles,
   collectFilesStream,
   INDEXER_IGNORED_DIRS,
+  isIgnoredDir,
   indexDirectory,
   EMBEDDING_MODEL_ID,
   getActiveEmbeddingModel
 };
-//# sourceMappingURL=chunk-6FGTNOCP.js.map
+//# sourceMappingURL=chunk-JZOJC3S7.js.map

package/dist/{chunk-7S2ELKNU.js → chunk-XQEQLXY5.js}

@@ -1,7 +1,7 @@
 import {
   EMBEDDING_DIMENSION,
   EMBEDDING_MODEL_ID
-} from "./chunk-6FGTNOCP.js";
+} from "./chunk-JZOJC3S7.js";
 import {
   logger
 } from "./chunk-TYDMSHV7.js";
@@ -307,4 +307,4 @@ Or revert CTXLOOM_EMBEDDING_MODEL to "${existing.model}" to keep the existing in
 export {
   VectorStore
 };
-//# sourceMappingURL=chunk-7S2ELKNU.js.map
+//# sourceMappingURL=chunk-XQEQLXY5.js.map

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

@@ -8,8 +8,9 @@ import {
   generateEmbeddingBatch,
   getActiveEmbeddingModel,
   indexDirectory,
+  isIgnoredDir,
   resolveEmbeddingModel
-} from "./chunk-6FGTNOCP.js";
+} from "./chunk-JZOJC3S7.js";
 import "./chunk-TYDMSHV7.js";
 export {
   EMBEDDING_DIMENSION,
@@ -21,6 +22,7 @@ export {
   generateEmbeddingBatch,
   getActiveEmbeddingModel,
   indexDirectory,
+  isIgnoredDir,
   resolveEmbeddingModel
 };
-//# sourceMappingURL=embedder-2JWDJUE2.js.map
+//# sourceMappingURL=embedder-4MM7D3UE.js.map

package/dist/index.js

@@ -47,18 +47,19 @@ import {
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-QL5UJTQL.js";
+} from "./chunk-AF76TJPL.js";
 import {
   addCtxloomToConfig,
   detectInstalledClients
 } from "./chunk-YHLMQVBV.js";
 import {
   VectorStore
-} from "./chunk-7S2ELKNU.js";
+} from "./chunk-XQEQLXY5.js";
 import {
+  collectFiles,
   generateEmbedding,
   indexDirectory
-} from "./chunk-6FGTNOCP.js";
+} from "./chunk-JZOJC3S7.js";
 import "./chunk-5I6CJITG.js";
 import {
   logger
@@ -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.4".length > 0 ? "1.7.4" : "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-ZUDJHQ3T.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-ZUDJHQ3T.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-ZUDJHQ3T.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-ZUDJHQ3T.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-ZUDJHQ3T.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-ZUDJHQ3T.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-ZUDJHQ3T.js}

@@ -132,16 +132,18 @@ import {
   wrapBlock,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-QL5UJTQL.js";
+} from "./chunk-AF76TJPL.js";
 import {
   VectorStore
-} from "./chunk-7S2ELKNU.js";
+} from "./chunk-XQEQLXY5.js";
 import {
   EMBEDDING_DIMENSION,
+  INDEXER_IGNORED_DIRS,
   collectFiles,
   generateEmbedding,
-  indexDirectory
-} from "./chunk-6FGTNOCP.js";
+  indexDirectory,
+  isIgnoredDir
+} from "./chunk-JZOJC3S7.js";
 import {
   filenameForDate,
   readEvents,
@@ -182,6 +184,7 @@ export {
   GrammarLoader,
   GraphExporter,
   HOST_ADAPTERS,
+  INDEXER_IGNORED_DIRS,
   InvalidKeyError,
   LicenseRequiredError,
   LicenseRevokedError,
@@ -256,6 +259,7 @@ export {
   inspectVectorsDb,
   installHarness,
   isActive,
+  isIgnoredDir,
   isSiloed,
   learnSuggestionsFromTelemetry,
   listNamedSnapshots,
@@ -300,4 +304,4 @@ export {
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-GTPLDFUS.js.map
+//# sourceMappingURL=src-ZUDJHQ3T.js.map

package/dist/workers/indexerWorker.js

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

package/package.json

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

@@ -1,9 +0,0 @@
-import {
-  VectorStore
-} from "./chunk-7S2ELKNU.js";
-import "./chunk-6FGTNOCP.js";
-import "./chunk-TYDMSHV7.js";
-export {
-  VectorStore
-};
-//# sourceMappingURL=VectorStore-WDL3H7QT.js.map