@cachly-dev/mcp-server 0.5.16 → 0.5.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.5.16",
+  "version": "0.5.18",
   "mcpName": "io.github.cachly-dev/mcp-server",
   "description": "AI memory brain for Claude Code, Cursor, Copilot & Windsurf — persistent sessions, lessons learned, semantic search, team brain. 38 MCP tools.",
   "type": "module",

package/src/index.ts

@@ -52,6 +52,7 @@ import { Redis } from 'ioredis';
 const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
 const JWT = process.env.CACHLY_JWT ?? '';
 const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
+const CURRENT_VERSION = '0.5.17';
 /**
  * ┌──────────────────────────────────────────────────────────────────────┐
  * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
@@ -1865,9 +1866,32 @@ function buildConnectionString(inst: Instance): string {
   return `${scheme}://${pw}${inst.host}:${inst.port}`;
 }
 
+// Fires once per process when no JWT is set (anonymous, opt-out via CACHLY_NO_TELEMETRY=1)
+let _telemetryPingSent = false;
+async function sendAnonymousTelemetry(toolName: string): Promise<void> {
+  if (_telemetryPingSent) return;
+  if (process.env.CACHLY_NO_TELEMETRY === '1') return;
+  _telemetryPingSent = true;
+  // Detect editor from common env vars injected by IDE extensions
+  const editor = process.env.CURSOR_TRACE_ID ? 'cursor'
+    : process.env.WINDSURF_SESSION_ID ? 'windsurf'
+    : process.env.GITHUB_COPILOT_WORKSPACE ? 'copilot'
+    : process.env.CLAUDE_CODE_ENTRYPOINT ? 'claude'
+    : 'unknown';
+  try {
+    await fetch(`${API_URL}/api/v1/telemetry/mcp`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ event: 'first_call_no_jwt', version: CURRENT_VERSION, editor, tool: toolName }),
+      signal: AbortSignal.timeout(3000),
+    });
+  } catch { /* fire-and-forget, never block the user */ }
+}
+
 async function handleTool(name: string, args: Record<string, unknown>): Promise<string> {
   // Guard: if no JWT, return actionable onboarding message instead of HTTP 401
   if (!JWT) {
+    void sendAnonymousTelemetry(name);
     return [
       '🧠 **cachly AI Brain — Setup required**',
       '',
@@ -4763,7 +4787,7 @@ async function handleBulkLockStream(name: string, args: Record<string, unknown>)
 // ── Server setup ──────────────────────────────────────────────────────────────
 
 const server = new Server(
-  { name: 'cachly-mcp', version: '0.4.0' },
+  { name: 'cachly-mcp', version: CURRENT_VERSION },
   { capabilities: { tools: {} } }
 );
 
@@ -5100,7 +5124,21 @@ if (process.argv[2] === 'setup') {
     : editorsRaw.split(/[,\s]+/).map(s => s.toLowerCase()).filter(s => EDITOR_FILES[s]);
   console.log('');
 
-  // ── Step 4: Write editor configs ──────────────────────────────────────────
+  // ── Step 4: Email opt-in ──────────────────────────────────────────────────
+  console.log('Step 4: Stay in the loop (optional)');
+  const email = await ask('   Email for release notes & tips? [Enter to skip]: ');
+  if (email && email.includes('@')) {
+    try {
+      await fetch(`${API_URL}/api/newsletter/subscribe`, {
+        method: 'POST', headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ email: email.trim().toLowerCase(), source: 'mcp-setup' }),
+        signal: AbortSignal.timeout(5000),
+      });
+      console.log('✅ Subscribed — you\'ll only hear from us when it matters.\n');
+    } catch { console.log('⚠️  Could not subscribe (no internet?). Continuing...\n'); }
+  } else { console.log('   Skipped.\n'); }
+
+  // ── Step 5: Write editor configs ──────────────────────────────────────────
   for (const editor of editorsToSetup) {
     const configFile = EDITOR_FILES[editor] ?? '.mcp.json';
     const configPath = resolve(cwd, configFile);
@@ -5109,7 +5147,7 @@ if (process.argv[2] === 'setup') {
     console.log(`✅ Written: ${configFile}`);
   }
 
-  // ── Step 5: CLAUDE.md (always — idempotent) ───────────────────────────────
+  // ── Step 6: CLAUDE.md (always — idempotent) ───────────────────────────────
   const mdResult = await writeClaudeMd(cwd, instance.id);
   const mdLabel = mdResult === 'updated' ? '✅ Updated' : mdResult === 'appended' ? '✅ Appended to' : '✅ Written';
   console.log(`${mdLabel}: CLAUDE.md`);
@@ -5145,6 +5183,30 @@ if (!JWT) {
   );
 }
 
+// ── Update nudge (non-blocking, fire-and-forget) ─────────────────────────────
+// Check npm registry once per process start; if outdated, log to stderr so
+// the editor's MCP log shows an actionable one-liner. Skipped if opted out.
+if (!process.env.CACHLY_NO_UPDATE_CHECK) {
+  (async () => {
+    try {
+      const res = await fetch(
+        `https://registry.npmjs.org/@cachly-dev/mcp-server/latest`,
+        { signal: AbortSignal.timeout(4000) },
+      );
+      if (res.ok) {
+        const data = await res.json() as { version: string };
+        const latest = data?.version ?? '';
+        if (latest && latest !== CURRENT_VERSION) {
+          process.stderr.write(
+            `\n⚡ cachly update available: ${CURRENT_VERSION} → ${latest}\n` +
+            `   Run: npx @cachly-dev/mcp-server@latest setup\n\n`,
+          );
+        }
+      }
+    } catch { /* ignore – network unavailable or timeout */ }
+  })();
+}
+
 const transport = new StdioServerTransport();
 await server.connect(transport);