ctxloom-pro 1.1.4 → 1.2.0

package/README.md

@@ -630,6 +630,19 @@ Token counts use the standard 4 chars/token approximation. Per-repo range (57–
 | `CTXLOOM_GRAMMAR_CDN` | CDN base URL for grammar downloads (air-gapped environments) | Built-in |
 | `CTXLOOM_MAX_PROJECTS` | LRU cache cap for multi-project state (v1.1.0+) | `5` |
 | `CTXLOOM_DISABLE_MULTIPROJECT` | Set to `1` to revert to v1.0.31 single-project mode (v1.1.0+) | (unset) |
+| `CTXLOOM_NO_TELEMETRY` | Set to `1` to disable anonymous telemetry entirely (v1.2.0+) | (unset) |
+| `CTXLOOM_TELEMETRY_LEVEL` | `all` / `error` / `off` — granular telemetry scope (v1.2.0+) | `all` |
+| `DO_NOT_TRACK` | Universal cross-tool opt-out — equivalent to `CTXLOOM_NO_TELEMETRY=1` | (unset) |
+
+---
+
+## Telemetry
+
+ctxloom collects **anonymous, opt-out telemetry** to understand which features are used and to catch crashes. **No file contents, paths, project names, or aliases are ever transmitted.** Project identifiers are SHA-256 hashes of the absolute path. The `distinct_id` is a random UUID at `~/.ctxloom/distinct_id`.
+
+Disable with `CTXLOOM_NO_TELEMETRY=1` or the cross-tool `DO_NOT_TRACK=1`. For a granular middle ground (crash reports yes, usage analytics no) use `CTXLOOM_TELEMETRY_LEVEL=error`.
+
+The complete list of events, properties, what is *never* collected, and how project paths are anonymized is documented in **[docs/TELEMETRY.md](docs/TELEMETRY.md)**.
 
 ---
 

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

@@ -169,12 +169,12 @@ var init_VectorStore = __esm({
 // server/index.ts
 import express from "express";
 import cors from "cors";
-import path42 from "path";
+import path43 from "path";
 import fs32 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // server/loader.ts
-import path36 from "path";
+import path37 from "path";
 
 // ../../packages/core/src/graph/DependencyGraph.ts
 import fs7 from "fs";
@@ -3133,8 +3133,8 @@ var CoChangeIndex = class _CoChangeIndex {
     if (event.isBulk || event.isMerge) return;
     const paths = event.files.map((f) => f.path);
     if (paths.length === 0) return;
-    for (const path43 of paths) {
-      this.nodeCounts.set(path43, (this.nodeCounts.get(path43) ?? 0) + 1);
+    for (const path44 of paths) {
+      this.nodeCounts.set(path44, (this.nodeCounts.get(path44) ?? 0) + 1);
     }
     for (let i = 0; i < paths.length; i++) {
       for (let j = i + 1; j < paths.length; j++) {
@@ -3281,8 +3281,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path43, raw] of this.nodes) {
-      nodes[path43] = {
+    for (const [path44, raw] of this.nodes) {
+      nodes[path44] = {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3297,8 +3297,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   static load(s) {
     const idx = new _ChurnIndex();
-    for (const [path43, raw] of Object.entries(s.nodes)) {
-      idx.nodes.set(path43, {
+    for (const [path44, raw] of Object.entries(s.nodes)) {
+      idx.nodes.set(path44, {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3311,8 +3311,8 @@ var ChurnIndex = class _ChurnIndex {
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path43) {
-    const existing = this.nodes.get(path43);
+  getOrCreate(path44) {
+    const existing = this.nodes.get(path44);
     if (existing !== void 0) return existing;
     const fresh = {
       commits: 0,
@@ -3321,7 +3321,7 @@ var ChurnIndex = class _ChurnIndex {
       authorCounts: {},
       lastTouch: 0
     };
-    this.nodes.set(path43, fresh);
+    this.nodes.set(path44, fresh);
     return fresh;
   }
 };
@@ -3402,12 +3402,12 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path43, raw] of this.nodes) {
+    for (const [path44, raw] of this.nodes) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      nodes[path43] = { authorWeights, lastTouch: raw.lastTouch };
+      nodes[path44] = { authorWeights, lastTouch: raw.lastTouch };
     }
     return { version: 1, nodes };
   }
@@ -3416,23 +3416,23 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   static load(s) {
     const idx = new _OwnershipIndex();
-    for (const [path43, raw] of Object.entries(s.nodes)) {
+    for (const [path44, raw] of Object.entries(s.nodes)) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      idx.nodes.set(path43, { authorWeights, lastTouch: raw.lastTouch });
+      idx.nodes.set(path44, { authorWeights, lastTouch: raw.lastTouch });
     }
     return idx;
   }
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path43) {
-    const existing = this.nodes.get(path43);
+  getOrCreate(path44) {
+    const existing = this.nodes.get(path44);
     if (existing !== void 0) return existing;
     const fresh = { authorWeights: {}, lastTouch: 0 };
-    this.nodes.set(path43, fresh);
+    this.nodes.set(path44, fresh);
     return fresh;
   }
 };
@@ -4670,8 +4670,8 @@ function getErrorMap() {
 
 // ../../node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path43, errorMaps, issueData } = params;
-  const fullPath = [...path43, ...issueData.path || []];
+  const { data, path: path44, errorMaps, issueData } = params;
+  const fullPath = [...path44, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -4787,11 +4787,11 @@ var errorUtil;
 
 // ../../node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path43, key) {
+  constructor(parent, value, path44, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path43;
+    this._path = path44;
     this._key = key;
   }
   get path() {
@@ -11311,11 +11311,20 @@ function markAliasSent(home) {
 }
 
 // ../../packages/core/src/license/telemetry.ts
-var TELEMETRY_DISABLED = process.env["CTXLOOM_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1";
-var CTXLOOM_VERSION = typeof __CTXLOOM_VERSION__ === "string" && __CTXLOOM_VERSION__.length > 0 ? __CTXLOOM_VERSION__ : "dev";
+function resolveTelemetryLevel() {
+  if (process.env["CTXLOOM_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1") {
+    return "off";
+  }
+  const raw = process.env["CTXLOOM_TELEMETRY_LEVEL"]?.toLowerCase();
+  if (raw === "off" || raw === "error" || raw === "all") return raw;
+  return "all";
+}
+var TELEMETRY_LEVEL = resolveTelemetryLevel();
+var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
+var CTXLOOM_VERSION = "1.2.0".length > 0 ? "1.2.0" : "dev";
 var POSTHOG_HOST = "https://eu.i.posthog.com";
-var POSTHOG_KEY = process.env["POSTHOG_API_KEY"] ?? (typeof __TELEMETRY_POSTHOG_KEY__ === "string" ? __TELEMETRY_POSTHOG_KEY__ : "");
-var SENTRY_DSN = process.env["SENTRY_DSN"] ?? (typeof __TELEMETRY_SENTRY_DSN__ === "string" ? __TELEMETRY_SENTRY_DSN__ : "");
+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" : "");
 var cachedDistinctId = null;
 function resolveDistinctId() {
   if (cachedDistinctId) return cachedDistinctId;
@@ -11327,7 +11336,7 @@ function resolveDistinctId() {
   }
 }
 function track(event, props = {}) {
-  if (TELEMETRY_DISABLED || !POSTHOG_KEY) return;
+  if (TELEMETRY_LEVEL !== "all" || !POSTHOG_KEY) return;
   const record = resolveDistinctId();
   if (!record) return;
   void sendPostHog(event, record.id, props);
@@ -11443,23 +11452,28 @@ function parseStack(stack) {
   }).filter((f) => f !== null).slice(0, 20);
 }
 
+// ../../packages/core/src/license/TelemetryNotice.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import path33 from "path";
+import os5 from "os";
+
 // ../../packages/core/src/server/ProjectState.ts
-import path34 from "path";
+import path35 from "path";
 
 // ../../packages/core/src/server/projectId.ts
 import crypto5 from "crypto";
-import path33 from "path";
+import path34 from "path";
 
 // ../../packages/core/src/server/ProjectStateManager.ts
 init_logger();
 
 // ../../packages/core/src/server/resolveProjectRoot.ts
 import fs29 from "fs";
-import path35 from "path";
+import path36 from "path";
 
 // server/loader.ts
 async function loadContext(root) {
-  const absRoot = path36.resolve(root);
+  const absRoot = path37.resolve(root);
   const overlay = new GitOverlayStore(absRoot);
   const gitEnabled = await overlay.loadSnapshot();
   const graph = new DependencyGraph();
@@ -11713,20 +11727,20 @@ function buildOwnershipRouter(ctx) {
 // server/routes/file.ts
 import { Router as Router7 } from "express";
 import fs30 from "fs/promises";
-import path37 from "path";
+import path38 from "path";
 function buildFileRouter(ctx) {
   const router = Router7();
   router.get("/", async (req, res) => {
     const rel = req.query.path;
     if (!rel) return res.status(400).json({ error: "missing path" });
-    const abs = path37.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path37.sep) ? ctx.root : ctx.root + path37.sep;
+    const abs = path38.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path38.sep) ? ctx.root : ctx.root + path38.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
     try {
       const content = await fs30.readFile(abs, "utf-8");
-      const ext = path37.extname(abs).slice(1);
+      const ext = path38.extname(abs).slice(1);
       res.json({ content, lines: content.split("\n").length, ext });
     } catch {
       res.status(404).json({ error: "not found" });
@@ -11738,7 +11752,7 @@ function buildFileRouter(ctx) {
 // server/routes/open.ts
 import { Router as Router8 } from "express";
 import { execFile as execFile2 } from "child_process";
-import path38 from "path";
+import path39 from "path";
 function tryOpen(bin, abs) {
   return new Promise((resolve) => {
     execFile2(bin, [abs], { timeout: 5e3 }, (err) => resolve(!err));
@@ -11749,8 +11763,8 @@ function buildOpenRouter(ctx) {
   router.post("/", async (req, res) => {
     const rel = req.body?.path;
     if (!rel || typeof rel !== "string") return res.status(400).json({ error: "missing path" });
-    const abs = path38.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path38.sep) ? ctx.root : ctx.root + path38.sep;
+    const abs = path39.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path39.sep) ? ctx.root : ctx.root + path39.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
@@ -11762,7 +11776,7 @@ function buildOpenRouter(ctx) {
 
 // server/routes/tokens.ts
 import { Router as Router9 } from "express";
-import path39 from "path";
+import path40 from "path";
 import fs31 from "fs";
 var CHARS_PER_TOKEN = 4;
 var cache = null;
@@ -11778,7 +11792,7 @@ function buildTokensRouter(ctx) {
     let fullChars = 0;
     let skeletonChars = 0;
     for (const file of files) {
-      const absPath = path39.join(ctx.root, file);
+      const absPath = path40.join(ctx.root, file);
       try {
         const content = fs31.readFileSync(absPath, "utf-8");
         fullChars += content.length;
@@ -11881,21 +11895,21 @@ function buildFileTrendsRouter(ctx) {
 
 // server/routes/projects.ts
 import { Router as Router12 } from "express";
-import path41 from "path";
+import path42 from "path";
 
 // server/projects.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
-import os5 from "os";
-import path40 from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import os6 from "os";
+import path41 from "path";
 import crypto6 from "crypto";
-var HOME = os5.homedir();
-var REGISTRY_PATH = path40.join(HOME, ".ctxloom", "repos.json");
+var HOME = os6.homedir();
+var REGISTRY_PATH = path41.join(HOME, ".ctxloom", "repos.json");
 function slugFor(root) {
-  const abs = path40.resolve(root);
+  const abs = path41.resolve(root);
   return crypto6.createHash("sha1").update(abs).digest("hex").slice(0, 12);
 }
 function readRegistry() {
-  if (!existsSync3(REGISTRY_PATH)) return [];
+  if (!existsSync4(REGISTRY_PATH)) return [];
   try {
     const raw = readFileSync4(REGISTRY_PATH, "utf-8");
     const parsed = JSON.parse(raw);
@@ -11906,27 +11920,27 @@ function readRegistry() {
   }
 }
 function listProjects(defaultRoot) {
-  const absDefault = path40.resolve(defaultRoot);
+  const absDefault = path41.resolve(defaultRoot);
   const out = [
     {
       slug: slugFor(absDefault),
-      name: path40.basename(absDefault) || absDefault,
+      name: path41.basename(absDefault) || absDefault,
       root: absDefault,
       isDefault: true,
-      hasSnapshot: existsSync3(path40.join(absDefault, ".ctxloom"))
+      hasSnapshot: existsSync4(path41.join(absDefault, ".ctxloom"))
     }
   ];
   const seen = /* @__PURE__ */ new Set([absDefault]);
   for (const entry of readRegistry()) {
-    const abs = path40.resolve(entry.root);
+    const abs = path41.resolve(entry.root);
     if (seen.has(abs)) continue;
     seen.add(abs);
     const item = {
       slug: slugFor(abs),
-      name: entry.name ?? (path40.basename(abs) || abs),
+      name: entry.name ?? (path41.basename(abs) || abs),
       root: abs,
       isDefault: false,
-      hasSnapshot: existsSync3(path40.join(abs, ".ctxloom"))
+      hasSnapshot: existsSync4(path41.join(abs, ".ctxloom"))
     };
     if (entry.alias !== void 0) item.alias = entry.alias;
     out.push(item);
@@ -11979,7 +11993,7 @@ function buildProjectsRouter(deps) {
     } catch (err) {
       const detail = err instanceof Error ? err.message : String(err);
       res.status(500).json({
-        error: `failed to switch to ${path41.basename(target.root)}: ${detail}`
+        error: `failed to switch to ${path42.basename(target.root)}: ${detail}`
       });
     }
   });
@@ -12036,7 +12050,7 @@ function buildTelemetryRouter() {
 }
 
 // server/index.ts
-var __dirname2 = path42.dirname(fileURLToPath2(import.meta.url));
+var __dirname2 = path43.dirname(fileURLToPath2(import.meta.url));
 async function startDashboard(options) {
   const { root, port, open } = options;
   console.log(`ctxloom dashboard \u2014 loading context from ${root}...`);
@@ -12095,7 +12109,7 @@ async function startDashboard(options) {
       }
       activeWatcher = null;
     }
-    const snapshotDir = path42.join(targetRoot, ".ctxloom");
+    const snapshotDir = path43.join(targetRoot, ".ctxloom");
     try {
       activeWatcher = fs32.watch(snapshotDir, (_event, filename) => {
         if (!filename || !filename.includes("snapshot")) return;
@@ -12126,12 +12140,12 @@ async function startDashboard(options) {
       attachSnapshotWatcher(newRoot);
     }
   }));
-  const clientDist = path42.join(__dirname2, "../dashboard/client");
-  const clientDistExists = fs32.existsSync(path42.join(clientDist, "index.html"));
+  const clientDist = path43.join(__dirname2, "../dashboard/client");
+  const clientDistExists = fs32.existsSync(path43.join(clientDist, "index.html"));
   if (clientDistExists) {
     app.use(express.static(clientDist, { dotfiles: "allow" }));
     app.get(/.*/, (_req, res) => {
-      res.sendFile(path42.join(clientDist, "index.html"), { dotfiles: "allow" });
+      res.sendFile(path43.join(clientDist, "index.html"), { dotfiles: "allow" });
     });
   } else {
     app.get(/^\/(?!api\/).*/, (_req, res) => {

package/dist/{chunk-P5BGH7U6.js → chunk-4B2S3WJ5.js}

@@ -3406,8 +3406,8 @@ var CoChangeIndex = class _CoChangeIndex {
     if (event.isBulk || event.isMerge) return;
     const paths = event.files.map((f) => f.path);
     if (paths.length === 0) return;
-    for (const path34 of paths) {
-      this.nodeCounts.set(path34, (this.nodeCounts.get(path34) ?? 0) + 1);
+    for (const path35 of paths) {
+      this.nodeCounts.set(path35, (this.nodeCounts.get(path35) ?? 0) + 1);
     }
     for (let i = 0; i < paths.length; i++) {
       for (let j = i + 1; j < paths.length; j++) {
@@ -3554,8 +3554,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path34, raw] of this.nodes) {
-      nodes[path34] = {
+    for (const [path35, raw] of this.nodes) {
+      nodes[path35] = {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3570,8 +3570,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   static load(s) {
     const idx = new _ChurnIndex();
-    for (const [path34, raw] of Object.entries(s.nodes)) {
-      idx.nodes.set(path34, {
+    for (const [path35, raw] of Object.entries(s.nodes)) {
+      idx.nodes.set(path35, {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3584,8 +3584,8 @@ var ChurnIndex = class _ChurnIndex {
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path34) {
-    const existing = this.nodes.get(path34);
+  getOrCreate(path35) {
+    const existing = this.nodes.get(path35);
     if (existing !== void 0) return existing;
     const fresh = {
       commits: 0,
@@ -3594,7 +3594,7 @@ var ChurnIndex = class _ChurnIndex {
       authorCounts: {},
       lastTouch: 0
     };
-    this.nodes.set(path34, fresh);
+    this.nodes.set(path35, fresh);
     return fresh;
   }
 };
@@ -3675,12 +3675,12 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path34, raw] of this.nodes) {
+    for (const [path35, raw] of this.nodes) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      nodes[path34] = { authorWeights, lastTouch: raw.lastTouch };
+      nodes[path35] = { authorWeights, lastTouch: raw.lastTouch };
     }
     return { version: 1, nodes };
   }
@@ -3689,23 +3689,23 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   static load(s) {
     const idx = new _OwnershipIndex();
-    for (const [path34, raw] of Object.entries(s.nodes)) {
+    for (const [path35, raw] of Object.entries(s.nodes)) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      idx.nodes.set(path34, { authorWeights, lastTouch: raw.lastTouch });
+      idx.nodes.set(path35, { authorWeights, lastTouch: raw.lastTouch });
     }
     return idx;
   }
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path34) {
-    const existing = this.nodes.get(path34);
+  getOrCreate(path35) {
+    const existing = this.nodes.get(path35);
     if (existing !== void 0) return existing;
     const fresh = { authorWeights: {}, lastTouch: 0 };
-    this.nodes.set(path34, fresh);
+    this.nodes.set(path35, fresh);
     return fresh;
   }
 };
@@ -8837,8 +8837,20 @@ function markAliasSent(home) {
 }
 
 // packages/core/src/license/telemetry.ts
-var TELEMETRY_DISABLED = process.env["CTXLOOM_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1";
-var CTXLOOM_VERSION = "1.1.4".length > 0 ? "1.1.4" : "dev";
+function resolveTelemetryLevel() {
+  if (process.env["CTXLOOM_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1") {
+    return "off";
+  }
+  const raw = process.env["CTXLOOM_TELEMETRY_LEVEL"]?.toLowerCase();
+  if (raw === "off" || raw === "error" || raw === "all") return raw;
+  return "all";
+}
+var TELEMETRY_LEVEL = resolveTelemetryLevel();
+var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
+function getTelemetryLevel() {
+  return TELEMETRY_LEVEL;
+}
+var CTXLOOM_VERSION = "1.2.0".length > 0 ? "1.2.0" : "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" : "");
@@ -8853,7 +8865,7 @@ function resolveDistinctId() {
   }
 }
 function track(event, props = {}) {
-  if (TELEMETRY_DISABLED || !POSTHOG_KEY) return;
+  if (TELEMETRY_LEVEL !== "all" || !POSTHOG_KEY) return;
   const record = resolveDistinctId();
   if (!record) return;
   void sendPostHog(event, record.id, props);
@@ -8969,14 +8981,32 @@ function parseStack(stack) {
   }).filter((f) => f !== null).slice(0, 20);
 }
 
+// packages/core/src/license/TelemetryNotice.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import path31 from "path";
+import os5 from "os";
+function noticePath(home) {
+  return path31.join(home ?? os5.homedir(), ".ctxloom", "telemetry_notice_shown");
+}
+function shouldShowTelemetryNotice(home) {
+  const filePath = noticePath(home);
+  if (existsSync3(filePath)) return false;
+  try {
+    mkdirSync3(path31.dirname(filePath), { recursive: true });
+    writeFileSync3(filePath, (/* @__PURE__ */ new Date()).toISOString(), { mode: 384 });
+  } catch {
+  }
+  return true;
+}
+
 // packages/core/src/server/ProjectState.ts
-import path32 from "path";
+import path33 from "path";
 
 // packages/core/src/server/projectId.ts
 import crypto5 from "crypto";
-import path31 from "path";
+import path32 from "path";
 function hashProjectRoot(absPath) {
-  const canonical = path31.resolve(absPath);
+  const canonical = path32.resolve(absPath);
   return crypto5.createHash("sha256").update(canonical).digest("hex").slice(0, 16);
 }
 
@@ -8984,7 +9014,7 @@ function hashProjectRoot(absPath) {
 function createProjectState(projectRoot, opts = {}) {
   return {
     projectRoot,
-    dbPath: path32.join(projectRoot, ".ctxloom", "vectors.lancedb"),
+    dbPath: path33.join(projectRoot, ".ctxloom", "vectors.lancedb"),
     pinned: opts.pinned ?? false,
     lastTouchedAt: Date.now(),
     vectorsInitialized: false,
@@ -9137,7 +9167,7 @@ var ProjectStateManager = class {
 
 // packages/core/src/server/resolveProjectRoot.ts
 import fs27 from "fs";
-import path33 from "path";
+import path34 from "path";
 var PATH_SEPARATOR_PATTERN = /[/\\~]|^[A-Za-z]:/;
 function looksLikePath(value) {
   return PATH_SEPARATOR_PATTERN.test(value);
@@ -9162,9 +9192,9 @@ function resolvePathSafely(p, cwd) {
   let expanded = p;
   if (p === "~" || p.startsWith("~/")) {
     const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-    expanded = p === "~" ? home : path33.join(home, p.slice(2));
+    expanded = p === "~" ? home : path34.join(home, p.slice(2));
   }
-  return path33.isAbsolute(expanded) ? path33.resolve(expanded) : path33.resolve(cwd, expanded);
+  return path34.isAbsolute(expanded) ? path34.resolve(expanded) : path34.resolve(cwd, expanded);
 }
 function realpathOrSame(p) {
   try {
@@ -9236,7 +9266,7 @@ function validateDefaultRoot(candidate) {
   } catch {
     return false;
   }
-  return PROJECT_MARKERS.some((m) => fs27.existsSync(path33.join(candidate, m)));
+  return PROJECT_MARKERS.some((m) => fs27.existsSync(path34.join(candidate, m)));
 }
 
 // packages/core/src/server/structuredErrors.ts
@@ -9391,8 +9421,10 @@ export {
   startTrial,
   getOrCreateDistinctId,
   markAliasSent,
+  getTelemetryLevel,
   track,
   captureError,
+  shouldShowTelemetryNotice,
   hashProjectRoot,
   createProjectState,
   ensureVectorsInitialized,
@@ -9409,4 +9441,4 @@ export {
   FirstTouchTracker,
   EmittedOnceTracker
 };
-//# sourceMappingURL=chunk-P5BGH7U6.js.map
+//# sourceMappingURL=chunk-4B2S3WJ5.js.map

package/dist/index.js

@@ -31,6 +31,7 @@ import {
   ensureVectorsInitialized,
   generateCODEOWNERS,
   getLicenseInfo,
+  getTelemetryLevel,
   hashProjectRoot,
   isActive,
   loadReviewConfig,
@@ -40,12 +41,13 @@ import {
   resolveProjectRoot,
   resolveViaGitHubApi,
   scoreReviewers,
+  shouldShowTelemetryNotice,
   startTrial,
   track,
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-P5BGH7U6.js";
+} from "./chunk-4B2S3WJ5.js";
 import {
   VectorStore
 } from "./chunk-NEHYSE2Y.js";
@@ -892,7 +894,7 @@ try {
 } catch {
 }
 var args = process.argv.slice(2);
-var ctxloomVersion = "1.1.4".length > 0 ? "1.1.4" : "dev";
+var ctxloomVersion = "1.2.0".length > 0 ? "1.2.0" : "dev";
 if (args.includes("--version") || args.includes("-v")) {
   process.stdout.write(`ctxloom ${ctxloomVersion}
 `);
@@ -965,7 +967,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-243TE3YF.js");
+    const { ApiClient } = await import("./src-CNHVHDBT.js");
     const client = new ApiClient(process.env["CTXLOOM_API_BASE"]);
     try {
       const result = await client.validate(ciKey, "ci-ephemeral");
@@ -1169,7 +1171,26 @@ async function runStatus() {
   ]));
   process.stdout.write("\n");
 }
+function maybePrintTelemetryNotice() {
+  if (command === void 0) return;
+  if (getTelemetryLevel() === "off") return;
+  if (!shouldShowTelemetryNotice()) return;
+  process.stderr.write(
+    `
+${style.dim("\u2500".repeat(60))}
+${style.bold("ctxloom collects anonymous usage telemetry")} to improve the tool.
+No file contents, paths, or aliases are ever transmitted.
+
+Disable with:   ${style.highlight("CTXLOOM_NO_TELEMETRY=1")}
+Errors only:    ${style.highlight("CTXLOOM_TELEMETRY_LEVEL=error")}
+Details:        ${style.highlight("https://github.com/kodiii/ctxloom/blob/main/docs/TELEMETRY.md")}
+${style.dim("\u2500".repeat(60))}
+
+`
+  );
+}
 async function main() {
+  maybePrintTelemetryNotice();
   await checkLicense();
   switch (command) {
     case "trial": {
@@ -1318,7 +1339,7 @@ async function main() {
         process.exit(1);
       }
       if (alias !== void 0) {
-        const { validateAlias } = await import("./src-243TE3YF.js");
+        const { validateAlias } = await import("./src-CNHVHDBT.js");
         const v = validateAlias(alias);
         if (!v.ok) {
           console.error(`[ctxloom] Invalid alias: ${v.reason}`);
@@ -1562,7 +1583,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-243TE3YF.js");
+      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-CNHVHDBT.js");
       let config;
       try {
         config = await loadRulesConfig(root);
@@ -1586,7 +1607,7 @@ Suggested reviewers for ${files.length} file(s):`);
       }
       let graph;
       if (useSnapshot) {
-        const { DependencyGraph: DG } = await import("./src-243TE3YF.js");
+        const { DependencyGraph: DG } = await import("./src-CNHVHDBT.js");
         graph = new DG();
         const loaded = await graph.loadSnapshotOnly(root);
         if (!loaded) {
@@ -1595,7 +1616,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-243TE3YF.js");
+        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-CNHVHDBT.js");
         let parser;
         try {
           parser = new ASTParser2();

package/dist/{src-243TE3YF.js → src-CNHVHDBT.js}

@@ -68,6 +68,7 @@ import {
   getImpactRadius,
   getLicenseInfo,
   getOrCreateDistinctId,
+  getTelemetryLevel,
   hashProjectRoot,
   isActive,
   isSiloed,
@@ -93,13 +94,14 @@ import {
   scoreAll,
   scoreFromBreakdown,
   scoreReviewers,
+  shouldShowTelemetryNotice,
   startTrial,
   track,
   validateAlias,
   validateDefaultRoot,
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
-} from "./chunk-P5BGH7U6.js";
+} from "./chunk-4B2S3WJ5.js";
 import {
   VectorStore
 } from "./chunk-NEHYSE2Y.js";
@@ -186,6 +188,7 @@ export {
   getImpactRadius,
   getLicenseInfo,
   getOrCreateDistinctId,
+  getTelemetryLevel,
   hashProjectRoot,
   indexDirectory,
   isActive,
@@ -213,6 +216,7 @@ export {
   scoreAll,
   scoreFromBreakdown,
   scoreReviewers,
+  shouldShowTelemetryNotice,
   startTrial,
   track,
   validateAlias,
@@ -220,4 +224,4 @@ export {
   wrapWithIndexingEnvelope,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-243TE3YF.js.map
+//# sourceMappingURL=src-CNHVHDBT.js.map

package/package.json

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