@cachly-dev/mcp-server 0.10.24 → 0.10.25

package/dist/index.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { jwtExpiryMs, checkJwt, handleApiError } from './auth.js';
-import { readFile } from 'node:fs/promises';
 /**
  * cachly MCP Server v0.4.0
  *
@@ -43,7 +42,7 @@ import { Redis } from 'ioredis';
 const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
 let JWT = process.env.CACHLY_JWT ?? '';
 const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
-const CURRENT_VERSION = '0.10.24';
+const CURRENT_VERSION = '0.10.10';
 // ── Default Instance Resolution (for Smithery & single-credential setups) ────
 // When CACHLY_BRAIN_INSTANCE_ID is set, tools can omit the instance_id parameter.
 // When neither is set, we auto-fetch the first running instance once per process.
@@ -140,7 +139,6 @@ async function pollDeviceFlow(flow) {
             JWT = apiKey;
             setEmbedJwt(apiKey); // keep embeddings.ts in sync
             _deviceFlow = null;
-            sendFunnelEvent('device_flow_completed');
             // Auto-provision: find or create the user's brain instance.
             _defaultInstanceLastAttempt = 0;
             await resolveDefaultInstanceId();
@@ -157,17 +155,8 @@ async function pollDeviceFlow(flow) {
                         if (id)
                             _defaultInstanceId = id;
                     }
-                    else {
-                        // Log so telemetry can detect free-tier auto-provision failures
-                        void fetch(`${API_URL}/api/v1/telemetry/mcp`, {
-                            method: 'POST',
-                            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${JWT}` },
-                            body: JSON.stringify({ event: 'auto_provision_failed', status: autoRes.status, version: CURRENT_VERSION }),
-                            signal: AbortSignal.timeout(3000),
-                        }).catch(() => { });
-                    }
                 }
-                catch { /* non-fatal — server unreachable, getConnection will surface the error */ }
+                catch { /* non-fatal */ }
             }
             // Give a provisioning instance a head-start so getConnection's wait is shorter.
             // The instance is almost always ready by the time the user's tool re-enters.
@@ -248,28 +237,11 @@ async function getConnection(instance_id) {
             body: JSON.stringify({ event: 'instance_not_reachable', instance_id, status: inst.status, version: CURRENT_VERSION }),
             signal: AbortSignal.timeout(3000),
         }).catch(() => { });
-        let hint;
-        if (inst.status === 'provisioning') {
-            hint = `⏳ Brain instance "${inst.name}" is still starting up.\n\nFirst-time provisioning typically takes 1–3 minutes. Please retry in a moment — the instance will be ready soon.`;
-        }
-        else if (inst.status === 'failed') {
-            hint = `❌ Brain instance "${inst.name}" failed to start.\n\n` +
-                `Our system will retry automatically. Check status at: https://cachly.dev/instances\n` +
-                `If this persists, contact support@cachly.dev.`;
-        }
-        else if (inst.status === 'suspended') {
-            hint = `⏸ Brain instance "${inst.name}" is suspended (billing issue).\n\n` +
-                `Update your payment method at: https://cachly.dev/billing`;
-        }
-        else if (inst.status === 'pending_payment') {
-            hint = `💳 Brain instance "${inst.name}" is waiting for payment.\n\n` +
-                `Complete your checkout at: https://cachly.dev/instances`;
-        }
-        else {
-            hint = `Brain instance "${inst.name}" is not reachable (status: ${inst.status}).\n\n` +
+        const hint = inst.status === 'provisioning'
+            ? `⏳ Brain instance "${inst.name}" is still starting up.\n\nThis usually finishes within 30 seconds. Please try again in a moment.`
+            : `Brain instance "${inst.name}" is not reachable (status: ${inst.status}).\n\n` +
                 `• View your instance at: https://cachly.dev/instances\n` +
                 `• Run \`get_api_status\` for a full diagnostic.`;
-        }
         throw new McpError(ErrorCode.InvalidRequest, hint);
     }
     if (!inst.host || !inst.port) {
@@ -283,14 +255,8 @@ async function getConnection(instance_id) {
         password = conn.password ?? undefined;
         tlsEnabled = conn.tls_enabled !== false;
     }
-    catch (connErr) {
-        // If the connection endpoint fails and the instance has a password, we cannot connect.
-        // Surface the error so the user knows why Redis auth will fail rather than getting a cryptic NOAUTH.
-        const msg = connErr instanceof Error ? connErr.message : String(connErr);
-        if (msg.includes('401') || msg.includes('403') || msg.includes('Unauthorized')) {
-            throw new McpError(ErrorCode.InvalidRequest, `API key rejected — run \`cachly setup\` to refresh your credentials.`);
-        }
-        // Other failures (timeout, 500): proceed without password, Redis will surface NOAUTH if needed
+    catch {
+        // Fallback: use TLS flag from instance metadata
     }
     const client = new Redis({
         host: inst.host,
@@ -361,40 +327,23 @@ import { TOOLS } from './tools.js';
 // ── Handlers ──────────────────────────────────────────────────────────────────
 // Fires once per process when no JWT is set (anonymous, opt-out via CACHLY_NO_TELEMETRY=1)
 let _telemetryPingSent = false;
-// Fires once per process on the first successful Brain tool call — key activation metric
-let _firstCallSuccessSent = false;
-function detectEditor() {
-    return 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';
-}
-function sendFunnelEvent(event, extra) {
-    if (process.env.CACHLY_NO_TELEMETRY === '1')
-        return;
-    void fetch(`${API_URL}/api/v1/telemetry/mcp`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-            event, version: CURRENT_VERSION, editor: detectEditor(),
-            ...(JWT ? { jwt: JWT } : {}),
-            ...extra,
-        }),
-        signal: AbortSignal.timeout(3000),
-    }).catch(() => { });
-}
 async function sendAnonymousTelemetry(toolName) {
     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: detectEditor(), tool: toolName }),
+            body: JSON.stringify({ event: 'first_call_no_jwt', version: CURRENT_VERSION, editor, tool: toolName }),
             signal: AbortSignal.timeout(3000),
         });
     }
@@ -431,29 +380,18 @@ async function handleTool(name, args) {
         const flow = await startDeviceFlow();
         if (flow) {
             _deviceFlow = flow;
-            sendFunnelEvent('device_flow_started', { tool: name });
-            // Try to open the browser automatically — fire-and-forget, never block
-            void (async () => {
-                try {
-                    const { exec } = await import('node:child_process');
-                    const url = flow.verifyUrl;
-                    const cmd = process.platform === 'win32' ? `start "" "${url}"`
-                        : process.platform === 'darwin' ? `open "${url}"`
-                            : `xdg-open "${url}"`;
-                    exec(cmd);
-                }
-                catch { /* non-critical */ }
-            })();
             return [
-                '🧠 **cachly AI Brain — sign in to activate** (browser opening...)',
+                '🧠 **cachly AI Brain — One-click sign in**',
                 '',
-                `👉 **${flow.verifyUrl}**`,
+                '1. Open this URL in your browser (it may open automatically):',
+                `   **${flow.verifyUrl}**`,
                 '',
-                `Code: **${flow.userCode}** (pre-filled if browser opened automatically)`,
+                `2. Enter this code if prompted: **${flow.userCode}**`,
                 '',
-                'After sign-in: call **any tool again** — your Brain activates instantly.',
+                '3. After sign-in, call this tool again — it will proceed automatically.',
                 '',
-                '✨ Free forever · No credit card · 89 MCP tools · GDPR · EU servers',
+                '✨ Free tier includes: 1 Brain instance, persistent memory, 63 MCP tools.',
+                '   No credit card required.',
             ].join('\n');
         }
         // Device flow unavailable (network issue) — fall back to manual setup
@@ -478,22 +416,12 @@ async function handleTool(name, args) {
     }
     // Delegate brain tools (learn, recall, session, etc.)
     const brainResult = await handleBrainTool(name, args, getConnection, apiFetch);
-    if (brainResult !== null) {
-        if (!_firstCallSuccessSent && JWT) {
-            _firstCallSuccessSent = true;
-            sendFunnelEvent('first_call_success', { tool: name, instance_id: args.instance_id ?? _defaultInstanceId ?? '' });
-        }
+    if (brainResult !== null)
         return brainResult;
-    }
     // Delegate context tools (remember/recall/list/forget)
     const contextResult = await handleContextTool(name, args, getConnection, apiFetch);
-    if (contextResult !== null) {
-        if (!_firstCallSuccessSent && JWT) {
-            _firstCallSuccessSent = true;
-            sendFunnelEvent('first_call_success', { tool: name, instance_id: args.instance_id ?? _defaultInstanceId ?? '' });
-        }
+    if (contextResult !== null)
         return contextResult;
-    }
     // Delegate instance + cache tools
     const instanceResult = await handleInstanceTool(name, args, getConnection, apiFetch);
     if (instanceResult !== null)
@@ -629,7 +557,32 @@ async function handleTool(name, args) {
     }
 }
 const server = new Server({ name: 'cachly-mcp', version: CURRENT_VERSION }, { capabilities: { tools: {} } });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    if (!JWT) {
+        // No credentials — inject sign-up CTA into session_start description
+        const tools = TOOLS.map(t => {
+            if (t.name !== 'session_start')
+                return t;
+            return {
+                ...t,
+                description: `⚡ FREE AI BRAIN — sign up once at https://cachly.dev/sign-up (no credit card) ` +
+                    `then run: npx @cachly-dev/mcp-server@latest setup\n\n` + t.description,
+            };
+        });
+        return { tools };
+    }
+    // ── Auto-start session on connection (fire and forget) ────────────────────
+    // When the AI reads the tools list, it has just connected. Proactively start
+    // the Brain session in the background so by the time the first tool call
+    // arrives, session context is already loaded and ready to inject.
+    if (!_autoSessionStarted && !_autoSessionStarting) {
+        void resolveDefaultInstanceId().then(instanceId => {
+            if (instanceId)
+                void autoStartSession(instanceId).catch(() => undefined);
+        }).catch(() => undefined);
+    }
+    return { tools: TOOLS };
+});
 // ── Auto-session management ───────────────────────────────────────────────────
 // Transparently starts a Brain session on the first tool call of a process
 // and saves a session_end summary on SIGTERM/exit so users never have to call
@@ -638,62 +591,87 @@ let _autoSessionInstanceId = null;
 let _autoSessionStarted = false;
 let _autoSessionStarting = null; // guard against double-start race
 let _autoSessionToolCount = 0;
+let _autoSessionContext = null; // result of session_start, injected into first tool response
+let _autoSessionContextInjected = false; // only inject once
 // ── brain_from_git concurrency limiter ────────────────────────────────────────
 // Spawning many `git log` subprocesses in parallel can fork-bomb the host.
 // This simple semaphore caps concurrent brain_from_git calls to 10 per process.
 async function autoStartSession(instanceId) {
     if (_autoSessionStarted)
-        return;
+        return null;
     // If another call already started the session, await it instead of double-starting.
     if (_autoSessionStarting) {
-        await _autoSessionStarting;
-        return;
+        return _autoSessionStarting;
     }
     _autoSessionStarting = (async () => {
         _autoSessionStarted = true;
         _autoSessionInstanceId = instanceId;
+        let sessionResult = null;
         try {
-            await handleTool('session_start', { instance_id: instanceId, focus: 'auto (MCP session)' });
+            // Auto-detect git context for a meaningful session focus
+            let focus = 'auto (MCP session)';
+            try {
+                const { execSync } = await import('node:child_process');
+                const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 }).trim();
+                const lastMsg = execSync('git log -1 --pretty=%s', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 }).trim();
+                if (branch && branch !== 'HEAD') {
+                    focus = lastMsg ? `${branch}: ${lastMsg.slice(0, 80)}` : `branch: ${branch}`;
+                }
+            }
+            catch { /* git not available in this workspace */ }
+            sessionResult = await handleTool('session_start', { instance_id: instanceId, focus });
+            _autoSessionContext = sessionResult;
         }
         catch { /* non-fatal — session tracking is a best-effort feature */ }
         finally {
             _autoSessionStarting = null;
         }
-    })();
-    await _autoSessionStarting;
-    // Auto-index the project if it hasn't been indexed in the last 24h.
-    // This is the main lever for growing token savings: more indexed code →
-    // more semantic cache hits → fewer LLM calls for repeated questions.
-    if (process.env.CACHLY_AUTO_INDEX !== 'false') {
-        try {
-            const redis = await getConnection(instanceId);
-            const lastIndexed = await redis.get(`cachly:index:last_indexed:${instanceId}`);
-            const staleMs = 24 * 60 * 60 * 1000;
-            const isStale = !lastIndexed || (Date.now() - parseInt(lastIndexed, 10)) > staleMs;
-            if (isStale) {
-                // Mark as indexing now to prevent concurrent re-runs.
-                await redis.set(`cachly:index:last_indexed:${instanceId}`, String(Date.now()), 'EX', 90000);
-                // Run in background — don't block the first tool call.
-                handleTool('index_project', {
-                    instance_id: instanceId,
-                    dir: process.cwd(),
-                    max_files: 150,
-                    ttl: 86400 * 7, // cache for 7 days
-                    namespace: 'cachly:sem:code',
-                }).catch(() => undefined);
+        // Auto-index the project if it hasn't been indexed in the last 24h.
+        // This is the main lever for growing token savings: more indexed code →
+        // more semantic cache hits → fewer LLM calls for repeated questions.
+        if (process.env.CACHLY_AUTO_INDEX !== 'false') {
+            try {
+                const redis = await getConnection(instanceId);
+                const lastIndexed = await redis.get(`cachly:index:last_indexed:${instanceId}`);
+                const staleMs = 24 * 60 * 60 * 1000;
+                const isStale = !lastIndexed || (Date.now() - parseInt(lastIndexed, 10)) > staleMs;
+                if (isStale) {
+                    // Mark as indexing now to prevent concurrent re-runs.
+                    await redis.set(`cachly:index:last_indexed:${instanceId}`, String(Date.now()), 'EX', 90000);
+                    // Run in background — don't block the first tool call.
+                    handleTool('index_project', {
+                        instance_id: instanceId,
+                        dir: process.cwd(),
+                        max_files: 150,
+                        ttl: 86400 * 7, // cache for 7 days
+                        namespace: 'cachly:sem:code',
+                    }).catch(() => undefined);
+                }
             }
+            catch { /* never block the session on indexing errors */ }
         }
-        catch { /* never block the session on indexing errors */ }
-    }
+        return sessionResult;
+    })();
+    return _autoSessionStarting;
 }
 async function autoEndSession() {
     if (!_autoSessionStarted || !_autoSessionInstanceId)
         return;
     _autoSessionStarted = false;
     try {
+        // Try to derive a meaningful summary from git
+        let summary = `Auto-ended after ${_autoSessionToolCount} tool call(s).`;
+        try {
+            const { execSync } = await import('node:child_process');
+            const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 }).trim();
+            const lastMsg = execSync('git log -1 --pretty=%s', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 }).trim();
+            if (lastMsg)
+                summary = `${branch ? `[${branch}] ` : ''}${lastMsg} · ${_autoSessionToolCount} tool calls`;
+        }
+        catch { /* git unavailable */ }
         await handleTool('session_end', {
             instance_id: _autoSessionInstanceId,
-            summary: `Auto-ended after ${_autoSessionToolCount} tool call(s). Session was started automatically.`,
+            summary,
             files_changed: [],
             lessons_learned: 0,
         });
@@ -702,7 +680,7 @@ async function autoEndSession() {
 }
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
-    // Auto-start brain session on first tool call that has an instance_id.
+    // Auto-start brain session if not yet started (fallback: ListTools already fired this).
     // Skip session management tools to avoid recursion.
     const sessionTools = new Set(['session_start', 'session_end', 'auto_learn_session']);
     if (!sessionTools.has(name) && !_autoSessionStarted && !_autoSessionStarting) {
@@ -721,6 +699,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         _autoSessionToolCount++;
     try {
         const text = await handleTool(name, (args ?? {}));
+        // ── Inject session context into the FIRST tool response ─────────────────
+        // This is the key: the AI sees the previous session summary, handoff tasks,
+        // and recent lessons automatically — without needing to call session_start.
+        // Only injected once per process (on the very first tool call).
+        if (!_autoSessionContextInjected && _autoSessionContext && !sessionTools.has(name)) {
+            _autoSessionContextInjected = true;
+            const ctx = _autoSessionContext;
+            _autoSessionContext = null; // free memory
+            return { content: [{ type: 'text', text: `${ctx}\n\n---\n\n${text}` }] };
+        }
         return { content: [{ type: 'text', text }] };
     }
     catch (err) {
@@ -796,54 +784,6 @@ function buildMcpConfig(apiKey, instanceId, editor) {
         },
     }, null, 2);
 }
-// mergeMcpConfig reads an existing config file (if any), merges the cachly entry,
-// and returns the updated JSON string — preserving all other MCP servers and settings.
-async function mergeMcpConfig(configPath, apiKey, instanceId, editor, fsOps) {
-    const cachlyEntry = {
-        command: 'npx',
-        args: ['-y', '@cachly-dev/mcp-server@latest'],
-        env: { CACHLY_API_URL: 'https://api.cachly.dev', CACHLY_JWT: apiKey, CACHLY_BRAIN_INSTANCE_ID: instanceId },
-    };
-    if (!fsOps.existsSync(configPath))
-        return buildMcpConfig(apiKey, instanceId, editor);
-    let existing = {};
-    try {
-        existing = JSON.parse(await fsOps.readFile(configPath, 'utf-8'));
-    }
-    catch {
-        // Corrupt or unreadable JSON — back it up by appending .bak, then start fresh
-        try {
-            const { rename } = await import('node:fs/promises');
-            await rename(configPath, configPath + '.bak');
-            process.stderr.write(`⚠️  ${configPath} was not valid JSON — backed up to ${configPath}.bak\n`);
-        }
-        catch { /* backup failed — still safe to overwrite with valid config */ }
-    }
-    if (editor === 'continue') {
-        // Merge into experimental.modelContextProtocolServers array — replace cachly entry if present
-        const exp = (existing['experimental'] ?? {});
-        const servers = (exp['modelContextProtocolServers'] ?? []);
-        const filtered = servers.filter((s) => {
-            const env = (s['env'] ?? {});
-            return !env['CACHLY_JWT'] && !env['CACHLY_BRAIN_INSTANCE_ID'];
-        });
-        filtered.push({ transport: { type: 'stdio', command: 'npx', args: ['-y', '@cachly-dev/mcp-server@latest'] }, env: cachlyEntry.env });
-        existing['experimental'] = { ...exp, modelContextProtocolServers: filtered };
-        return JSON.stringify(existing, null, 2);
-    }
-    if (editor === 'zed') {
-        // Merge only context_servers.cachly — preserve all other Zed settings
-        const cs = (existing['context_servers'] ?? {});
-        cs['cachly'] = { command: { path: 'npx', args: ['-y', '@cachly-dev/mcp-server@latest'], env: cachlyEntry.env }, settings: {} };
-        existing['context_servers'] = cs;
-        return JSON.stringify(existing, null, 2);
-    }
-    // Standard mcpServers format (Claude Code, Cursor, Windsurf, Copilot, Cline)
-    const servers = (existing['mcpServers'] ?? {});
-    servers['cachly'] = cachlyEntry;
-    existing['mcpServers'] = servers;
-    return JSON.stringify(existing, null, 2);
-}
 function buildClaudeMdBlock(instanceId) {
     return `${CLAUDE_MD_MARKER_START}
 ## Cachly AI Brain — Always Active
@@ -909,584 +849,6 @@ async function writeClaudeMd(projectDir, instanceId) {
     await writeFile(claudeMdPath, block.trimStart(), 'utf-8');
     return 'written';
 }
-// ── CLI: cachly digest ────────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest digest
-// Weekly brain summary — what your AI learned this week. Shareable output.
-if (process.argv[2] === 'digest') {
-    const apiKey = process.env.CACHLY_JWT ?? '';
-    const instanceId = process.env.CACHLY_BRAIN_INSTANCE_ID ?? '';
-    if (!apiKey || !instanceId) {
-        console.log('\n⚠️  CACHLY_JWT and CACHLY_BRAIN_INSTANCE_ID must be set.');
-        console.log('   Run: npx @cachly-dev/mcp-server@latest setup\n');
-        process.exit(1);
-    }
-    process.stdout.write('\n🧠 Fetching your weekly Brain digest...\n\n');
-    try {
-        // Fetch current stats
-        const statsRes = await fetch(`${API_URL}/api/v1/instances/${instanceId}/brain/stats`, {
-            headers: { Authorization: `Bearer ${apiKey}` },
-            signal: AbortSignal.timeout(8000),
-        });
-        if (!statsRes.ok)
-            throw new Error(`stats HTTP ${statsRes.status}`);
-        const stats = await statsRes.json();
-        const lessons = stats.lesson_count ?? 0;
-        const recalls = stats.total_recall_count ?? 0;
-        const score = Math.round((stats.quality_score ?? 0) * 100);
-        const topLessons = (stats.top_lessons ?? []).slice(0, 5);
-        const teamAuthors = stats.team_authors ?? [];
-        const tokensSaved = recalls * 1200;
-        const costSaved = (tokensSaved * 0.000003).toFixed(2);
-        const level = lessons < 10 ? 'Junior Dev 🔧' : lessons < 30 ? 'Mid Dev ⚡' :
-            lessons < 60 ? 'Senior Dev 🧠' : lessons < 100 ? 'Staff Eng 🚀' : 'Principal Eng 🏆';
-        const now = new Date();
-        const weekStart = new Date(now);
-        weekStart.setDate(now.getDate() - 7);
-        const fmt = (d) => d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
-        console.log('┌─────────────────────────────────────────────────────────────┐');
-        console.log(`│  \x1b[1m🧠 Brain Weekly Digest\x1b[0m  \x1b[90m${fmt(weekStart)} – ${fmt(now)}\x1b[0m                 │`);
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log(`│  Total lessons  : \x1b[33m${String(lessons).padEnd(8)}\x1b[0m  Brain level : \x1b[32m${level.padEnd(18)}\x1b[0m│`);
-        console.log(`│  Total recalls  : \x1b[36m${String(recalls).padEnd(8)}\x1b[0m  Quality score: \x1b[32m${String(score).padEnd(3)}%\x1b[0m              │`);
-        console.log(`│  Tokens saved   : \x1b[32m${String(Math.round(tokensSaved / 1000) + 'K').padEnd(8)}\x1b[0m  Cost saved   : \x1b[32m$${costSaved.padEnd(20)}\x1b[0m│`);
-        if (teamAuthors.length > 0) {
-            console.log('├─────────────────────────────────────────────────────────────┤');
-            console.log(`│  \x1b[36m👥 Team contributors:\x1b[0m ${teamAuthors.slice(0, 5).join(', ').slice(0, 42).padEnd(42)} │`);
-        }
-        if (topLessons.length > 0) {
-            console.log('├─────────────────────────────────────────────────────────────┤');
-            console.log('│  \x1b[33m🔥 Most recalled lessons this week:\x1b[0m                         │');
-            for (const l of topLessons) {
-                const line = `${l.topic}: ${l.what_worked}`.slice(0, 57);
-                console.log(`│  \x1b[90m• ${line.padEnd(58)}\x1b[0m│`);
-            }
-        }
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log('│  \x1b[32m📋 Share this digest:\x1b[0m                                        │');
-        console.log('│  \x1b[90m   npx @cachly-dev/mcp-server@latest share\x1b[0m                   │');
-        console.log('│  \x1b[90m   Add more: npx @cachly-dev/mcp-server@latest invite\x1b[0m         │');
-        console.log('└─────────────────────────────────────────────────────────────┘');
-        console.log('');
-        // Pro tip for cron
-        console.log('  \x1b[2m💡 Automate: add to crontab for a weekly team email\x1b[0m');
-        console.log('  \x1b[2m   0 9 * * 1 npx @cachly-dev/mcp-server@latest digest\x1b[0m');
-        console.log('');
-    }
-    catch (e) {
-        console.log(`\n❌ Could not fetch digest: ${e.message}\n`);
-        process.exit(1);
-    }
-    process.exit(0);
-}
-// ── CLI: cachly invite ────────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest invite [email]
-// Invites a teammate to share your Brain. Fastest referral loop.
-if (process.argv[2] === 'invite') {
-    const { createInterface } = await import('node:readline');
-    const apiKey = process.env.CACHLY_JWT ?? '';
-    if (!apiKey) {
-        console.log('\n⚠️  CACHLY_JWT must be set.');
-        console.log('   Run: npx @cachly-dev/mcp-server@latest setup\n');
-        process.exit(1);
-    }
-    let email = process.argv[3] ?? '';
-    if (!email) {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        email = await new Promise((resolve) => {
-            rl.question('\n  📬 Teammate email to invite: ', (ans) => { rl.close(); resolve(ans.trim()); });
-        });
-    }
-    if (!email || !email.includes('@')) {
-        console.log('\n❌ Invalid email address.\n');
-        process.exit(1);
-    }
-    console.log(`\n  ⏳ Inviting ${email}...`);
-    try {
-        const res = await fetch(`${API_URL}/api/v1/team/invite`, {
-            method: 'POST',
-            headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
-            body: JSON.stringify({ email, role: 'member', source: 'cli-invite' }),
-            signal: AbortSignal.timeout(8000),
-        });
-        if (res.ok) {
-            console.log(`\n  ✅ Invite sent to \x1b[32m${email}\x1b[0m`);
-            console.log(`     They'll get a link to join your Brain — one click, 30 seconds.\n`);
-            console.log(`  💡 Once they join, your AI assistants share lessons automatically.\n`);
-        }
-        else if (res.status === 409) {
-            console.log(`\n  ✓  ${email} is already a team member.\n`);
-        }
-        else {
-            const body = await res.json().catch(() => ({}));
-            console.log(`\n  ❌ Invite failed: ${body.error ?? `HTTP ${res.status}`}\n`);
-            process.exit(1);
-        }
-    }
-    catch (e) {
-        console.log(`\n  ❌ Network error: ${e.message}\n`);
-        process.exit(1);
-    }
-    process.exit(0);
-}
-// ── CLI: cachly join <token> ──────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest join <token>
-// Accepts a Brain invite link — writes the shared instance ID into all
-// detected editor MCP configs and the global ~/.claude/mcp.json.
-// No account needed if CACHLY_JWT is already set; otherwise prompts for auth.
-if (process.argv[2] === 'join') {
-    const { writeFile: wfJ, readFile: rfJ, mkdir: mkJ } = await import('node:fs/promises');
-    const { existsSync: exJ } = await import('node:fs');
-    const { resolve: resJ, dirname: dirJ } = await import('node:path');
-    const { homedir } = await import('node:os');
-    const { createInterface: ciJ } = await import('node:readline');
-    const token = process.argv[3] ?? '';
-    if (!token) {
-        console.log('\n❌ Usage: npx @cachly-dev/mcp-server@latest join <token>\n');
-        console.log('   Get a token from a teammate: npx @cachly-dev/mcp-server@latest invite\n');
-        process.exit(1);
-    }
-    console.log('\n⏳ Looking up invite...');
-    // ── Step 1: Fetch invite info (public, no auth) ───────────────────────────
-    let inviteInfo;
-    try {
-        const res = await fetch(`${API_URL}/api/invite/${token}`, { signal: AbortSignal.timeout(8000) });
-        if (res.status === 404) {
-            console.log('\n❌ Invite not found — the link may be invalid.\n');
-            process.exit(1);
-        }
-        if (res.status === 410) {
-            console.log('\n❌ This invite link has expired (7-day limit).\n');
-            process.exit(1);
-        }
-        if (!res.ok) {
-            console.log(`\n❌ Could not fetch invite: HTTP ${res.status}\n`);
-            process.exit(1);
-        }
-        inviteInfo = await res.json();
-    }
-    catch (e) {
-        console.log(`\n❌ Network error: ${e.message}\n`);
-        process.exit(1);
-    }
-    const { instance_id, instance_name, tier, label } = inviteInfo;
-    const expires = new Date(inviteInfo.expires_at).toLocaleDateString();
-    console.log('');
-    console.log('  \x1b[35m╔══════════════════════════════════════════════════════╗\x1b[0m');
-    console.log('  \x1b[35m║\x1b[0m  \x1b[1m🧠 Brain Invite\x1b[0m                                  \x1b[35m║\x1b[0m');
-    console.log('  \x1b[35m╚══════════════════════════════════════════════════════╝\x1b[0m');
-    console.log('');
-    console.log(`  Brain   : \x1b[1m${instance_name}\x1b[0m`);
-    console.log(`  Tier    : ${tier}`);
-    if (label)
-        console.log(`  Note    : ${label}`);
-    console.log(`  Expires : ${expires}`);
-    console.log('');
-    // ── Step 2: Confirm ───────────────────────────────────────────────────────
-    const rlJ = ciJ({ input: process.stdin, output: process.stdout });
-    const confirmJ = await new Promise((resolve) => {
-        rlJ.question('  Join this Brain? [Y/n] ', (a) => { rlJ.close(); resolve(a.trim().toLowerCase() || 'y'); });
-    });
-    if (confirmJ !== 'y' && confirmJ !== 'yes') {
-        console.log('\n  Cancelled.\n');
-        process.exit(0);
-    }
-    // ── Step 3: Ensure JWT ────────────────────────────────────────────────────
-    let joinJwt = JWT;
-    if (!joinJwt) {
-        console.log('\n  No API key found — starting sign-in (10 seconds)...\n');
-        try {
-            const dcRes = await fetch(`${API_URL}/api/v1/auth/device/code`, {
-                method: 'POST', headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ client_id: 'cachly-mcp-cli' }),
-                signal: AbortSignal.timeout(10000),
-            });
-            if (dcRes.ok) {
-                const dc = await dcRes.json();
-                console.log(`  👉 Open: \x1b[36m${dc.verification_uri}\x1b[0m`);
-                console.log(`     Code: \x1b[1m${dc.user_code}\x1b[0m\n`);
-                // Poll for token
-                const pollInterval = (dc.interval ?? 5) * 1000;
-                for (let i = 0; i < 24; i++) {
-                    await new Promise(r => setTimeout(r, pollInterval));
-                    try {
-                        const tokRes = await fetch(`${API_URL}/api/v1/auth/device/token`, {
-                            method: 'POST', headers: { 'Content-Type': 'application/json' },
-                            body: JSON.stringify({ device_code: dc.device_code, client_id: 'cachly-mcp-cli' }),
-                            signal: AbortSignal.timeout(8000),
-                        });
-                        if (tokRes.ok) {
-                            const tok = await tokRes.json();
-                            if (tok.access_token) {
-                                joinJwt = tok.access_token;
-                                break;
-                            }
-                        }
-                    }
-                    catch { /* polling — keep going */ }
-                }
-                if (!joinJwt) {
-                    console.log('\n❌ Sign-in timed out. Run the command again.\n');
-                    process.exit(1);
-                }
-                console.log('  ✅ Signed in!\n');
-            }
-        }
-        catch (e) {
-            console.log(`\n  ⚠️  Could not start sign-in: ${e.message}`);
-            console.log(`   Set CACHLY_JWT manually from https://cachly.dev/setup-ai\n`);
-            process.exit(1);
-        }
-    }
-    // ── Step 4: Write instance ID into all editor MCP configs ────────────────
-    const cwd = process.cwd();
-    const home = homedir();
-    const editorFiles = [
-        { label: '.mcp.json (Claude Code project)', path: resJ(cwd, '.mcp.json') },
-        { label: '.cursor/mcp.json', path: resJ(cwd, '.cursor', 'mcp.json') },
-        { label: '.windsurf/mcp.json', path: resJ(cwd, '.windsurf', 'mcp.json') },
-        { label: '.vscode/mcp.json (Copilot/Cline)', path: resJ(cwd, '.vscode', 'mcp.json') },
-        { label: '~/.claude/mcp.json (global)', path: resJ(home, '.claude', 'mcp.json'), global: true },
-    ];
-    let written = 0;
-    for (const { label: eLabel, path: ePath, global: isGlobal } of editorFiles) {
-        // Only write project configs if the directory exists (or global)
-        const dir = dirJ(ePath);
-        if (!isGlobal && !exJ(dir) && !exJ(ePath))
-            continue;
-        try {
-            await mkJ(dir, { recursive: true });
-            let cfg = {};
-            if (exJ(ePath)) {
-                try {
-                    cfg = JSON.parse(await rfJ(ePath, 'utf-8'));
-                }
-                catch {
-                    try {
-                        await (await import('node:fs/promises')).rename(ePath, ePath + '.bak');
-                    }
-                    catch { /* backup failed */ }
-                }
-            }
-            // Update or create the cachly entry with the shared instance ID
-            const servers = (cfg['mcpServers'] ?? {});
-            const existing = (servers['cachly'] ?? {});
-            const env = (existing['env'] ?? {});
-            env['CACHLY_BRAIN_INSTANCE_ID'] = instance_id;
-            if (joinJwt && !env['CACHLY_JWT'])
-                env['CACHLY_JWT'] = joinJwt;
-            env['CACHLY_API_URL'] ??= 'https://api.cachly.dev';
-            servers['cachly'] = { ...existing, command: 'npx', args: ['-y', '@cachly-dev/mcp-server@latest'], env };
-            cfg['mcpServers'] = servers;
-            await wfJ(ePath, JSON.stringify(cfg, null, 2), 'utf-8');
-            console.log(`  ✅ ${eLabel}`);
-            written++;
-        }
-        catch (joinWriteErr) {
-            // Only surface unexpected errors — missing editor dirs are expected and silently skipped above
-            if (joinWriteErr.code !== 'ENOENT') {
-                console.log(`  ⚠️  ${eLabel}: ${joinWriteErr.message}`);
-            }
-        }
-    }
-    console.log('');
-    if (written === 0) {
-        console.log('  ⚠️  No editor configs found — run `cachly setup` first.\n');
-    }
-    else {
-        console.log(`  🧠 You're now sharing Brain: \x1b[1m${instance_name}\x1b[0m`);
-        console.log('     Restart your editor — your AI arrives pre-briefed from the team Brain.\n');
-        console.log('  📛 Add the badge to your README:');
-        console.log(`     npx @cachly-dev/mcp-server@latest badge\n`);
-    }
-    process.exit(0);
-}
-// ── CLI: cachly upgrade ───────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest upgrade
-// Checks npm for the latest version and prints upgrade instructions if outdated.
-if (process.argv[2] === 'upgrade') {
-    process.stdout.write('\n⏳ Checking for updates...\n');
-    try {
-        const res = await fetch('https://registry.npmjs.org/@cachly-dev/mcp-server/latest', {
-            signal: AbortSignal.timeout(8000),
-        });
-        if (!res.ok)
-            throw new Error(`registry HTTP ${res.status}`);
-        const pkg = await res.json();
-        const latest = pkg.version;
-        if (!latest || !/^\d+\.\d+\.\d+/.test(latest))
-            throw new Error('npm registry returned unexpected response');
-        if (latest === CURRENT_VERSION) {
-            console.log(`\n✅ Already on the latest version: \x1b[32mv${CURRENT_VERSION}\x1b[0m\n`);
-        }
-        else {
-            console.log('');
-            console.log('\x1b[35m  ╔══════════════════════════════════════════════════════╗\x1b[0m');
-            console.log('\x1b[35m  ║\x1b[0m  \x1b[1m🧠 cachly update available\x1b[0m                       \x1b[35m║\x1b[0m');
-            console.log('\x1b[35m  ╚══════════════════════════════════════════════════════╝\x1b[0m');
-            console.log('');
-            console.log(`  Current : \x1b[31mv${CURRENT_VERSION}\x1b[0m`);
-            console.log(`  Latest  : \x1b[32mv${latest}\x1b[0m`);
-            console.log('');
-            console.log('  Update your editor configs to pick up the new version:');
-            console.log('');
-            console.log('  \x1b[32m  npx @cachly-dev/mcp-server@latest setup\x1b[0m');
-            console.log('');
-            console.log('  \x1b[2m(npx always fetches the latest when @latest is specified)\x1b[0m');
-            console.log('');
-        }
-    }
-    catch (e) {
-        console.log(`\n❌ Could not check for updates: ${e.message}\n`);
-        process.exit(1);
-    }
-    process.exit(0);
-}
-// ── CLI: cachly demo ──────────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest demo
-// Zero-signup. Reads local git history and shows what the AI Brain would know.
-// The fastest path from "what is this?" to "I need this".
-if (process.argv[2] === 'demo') {
-    const { execSync } = await import('node:child_process');
-    const { existsSync } = await import('node:fs');
-    const { resolve } = await import('node:path');
-    const cwd = process.cwd();
-    console.log('\n\x1b[35m🧠 cachly Brain — Live Demo\x1b[0m');
-    console.log('\x1b[90mNo account needed. Reading your git history...\x1b[0m\n');
-    // Verify git repo
-    if (!existsSync(resolve(cwd, '.git'))) {
-        console.log('⚠️  No git repository found here.');
-        console.log('   Run this command inside a project directory with git history.\n');
-        console.log('   Example: cd ~/my-project && npx @cachly-dev/mcp-server@latest demo\n');
-        process.exit(0);
-    }
-    // Read git log
-    let logOutput = '';
-    try {
-        logOutput = execSync('git log HEAD --pretty=format:"%H|||%s|||%ad|||%an" --date=short --no-merges -n 200', { cwd, encoding: 'utf-8', stdio: 'pipe' });
-    }
-    catch {
-        console.log('⚠️  Could not read git log. Make sure you have commits.\n');
-        process.exit(0);
-    }
-    const commits = logOutput.trim().split('\n').filter(Boolean).map(line => {
-        const [sha, subject, date, author] = line.split('|||');
-        return { sha: (sha ?? '').trim().slice(0, 8), subject: (subject ?? '').trim(), date: (date ?? '').trim(), author: (author ?? '').trim() };
-    });
-    if (commits.length === 0) {
-        console.log('⚠️  No commits found.\n');
-        process.exit(0);
-    }
-    // Classify commits (same logic as brain_from_git)
-    const classify = (s) => {
-        const t = s.toLowerCase();
-        if (/\b(fix|fixed|bug|hotfix|patch|revert|resolve)\b/.test(t))
-            return 'fix';
-        if (/\b(feat|feature|add|implement|new|introduce)\b/.test(t))
-            return 'feat';
-        if (/\b(perf|optim|speed|cache|latency)\b/.test(t))
-            return 'perf';
-        if (/\b(security|cve|auth|csrf|xss|inject|sanitize)\b/.test(t))
-            return 'security';
-        if (/\b(deploy|ci|cd|docker|k8s|infra)\b/.test(t))
-            return 'deploy';
-        if (/\b(refactor|clean|simplify|extract)\b/.test(t))
-            return 'refactor';
-        return 'chore';
-    };
-    // Count categories
-    const cats = new Map();
-    const fixes = [];
-    const feats = [];
-    const security = [];
-    const authors = new Set();
-    for (const c of commits) {
-        const cat = classify(c.subject);
-        cats.set(cat, (cats.get(cat) ?? 0) + 1);
-        if (cat === 'fix' && fixes.length < 5)
-            fixes.push(c.subject.slice(0, 72));
-        if (cat === 'feat' && feats.length < 5)
-            feats.push(c.subject.slice(0, 72));
-        if (cat === 'security' && security.length < 3)
-            security.push(c.subject.slice(0, 72));
-        if (c.author)
-            authors.add(c.author.split(' ')[0]);
-    }
-    const totalLessons = commits.length - (cats.get('chore') ?? 0);
-    const dateRange = `${commits[commits.length - 1]?.date ?? '?'} → ${commits[0]?.date ?? '?'}`;
-    // Display the demo
-    process.stdout.write('\x1b[2K\r');
-    console.log('┌─────────────────────────────────────────────────────────────┐');
-    console.log('│  \x1b[1m🧠 Brain Preview — What your AI would know\x1b[0m                  │');
-    console.log('├─────────────────────────────────────────────────────────────┤');
-    console.log(`│  Commits analysed : \x1b[33m${String(commits.length).padEnd(6)}\x1b[0m  Date range: \x1b[90m${dateRange.slice(0, 23).padEnd(23)}\x1b[0m  │`);
-    console.log(`│  Lessons extracted: \x1b[32m${String(totalLessons).padEnd(6)}\x1b[0m  Contributors: \x1b[36m${String(authors.size).padEnd(20)}\x1b[0m│`);
-    console.log('├─────────────────────────────────────────────────────────────┤');
-    // Category breakdown
-    const sorted = [...cats.entries()].filter(([k]) => k !== 'chore').sort((a, b) => b[1] - a[1]);
-    const bar = (n, max) => '█'.repeat(Math.round((n / max) * 20)).padEnd(20);
-    const maxVal = Math.max(...sorted.map(([, v]) => v), 1);
-    console.log('│  \x1b[90mCategory breakdown:\x1b[0m                                         │');
-    for (const [cat, count] of sorted) {
-        const emoji = { fix: '🔧', feat: '✨', perf: '⚡', security: '🔒', deploy: '🚀', refactor: '🔄' }[cat] ?? '•';
-        console.log(`│  ${emoji} \x1b[36m${cat.padEnd(10)}\x1b[0m \x1b[35m${bar(count, maxVal)}\x1b[0m \x1b[33m${String(count).padStart(3)}\x1b[0m  │`);
-    }
-    if (security.length > 0) {
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log('│  \x1b[31m🔒 Security fixes your AI would know:\x1b[0m                       │');
-        for (const s of security)
-            console.log(`│  \x1b[90m• ${s.slice(0, 58).padEnd(58)}\x1b[0m │`);
-    }
-    if (fixes.length > 0) {
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log('│  \x1b[33m🔧 Bug fixes your AI would remember:\x1b[0m                        │');
-        for (const f of fixes.slice(0, 4))
-            console.log(`│  \x1b[90m• ${f.slice(0, 58).padEnd(58)}\x1b[0m │`);
-    }
-    if (feats.length > 0) {
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log('│  \x1b[32m✨ Features & decisions it would recall:\x1b[0m                    │');
-        for (const f of feats.slice(0, 3))
-            console.log(`│  \x1b[90m• ${f.slice(0, 58).padEnd(58)}\x1b[0m │`);
-    }
-    console.log('├─────────────────────────────────────────────────────────────┤');
-    console.log('│  \x1b[32m💡 With cachly, your AI arrives pre-briefed every session.\x1b[0m  │');
-    console.log('│  \x1b[32m   No more re-explaining. No more repeated mistakes.\x1b[0m         │');
-    console.log('└─────────────────────────────────────────────────────────────┘');
-    console.log('');
-    console.log('  \x1b[1mMake this permanent (free, 30 seconds):\x1b[0m');
-    console.log('  \x1b[32m$ npx @cachly-dev/mcp-server@latest setup\x1b[0m');
-    console.log('');
-    console.log('  Works with: Claude Code · Cursor · Windsurf · Copilot · Cline · Zed');
-    console.log('  Free forever · GDPR · German servers · No credit card');
-    console.log('');
-    process.exit(0);
-}
-// ── CLI: cachly share ─────────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest share
-// Generates a shareable ASCII card + tweet text with your Brain stats.
-if (process.argv[2] === 'share') {
-    const apiKey = process.env.CACHLY_JWT ?? '';
-    const instanceId = process.env.CACHLY_BRAIN_INSTANCE_ID ?? '';
-    if (!apiKey || !instanceId) {
-        console.log('\n⚠️  CACHLY_JWT and CACHLY_BRAIN_INSTANCE_ID must be set.');
-        console.log('   Run: npx @cachly-dev/mcp-server@latest setup  (takes 30 seconds)\n');
-        process.exit(1);
-    }
-    process.stdout.write('\n🧠 Fetching your Brain stats...\n');
-    try {
-        const statsRes = await fetch(`${API_URL}/api/v1/instances/${instanceId}/brain/stats`, {
-            headers: { Authorization: `Bearer ${apiKey}` },
-            signal: AbortSignal.timeout(8000),
-        });
-        if (!statsRes.ok)
-            throw new Error(`HTTP ${statsRes.status}`);
-        const stats = await statsRes.json();
-        const lessons = stats.lesson_count ?? 0;
-        const recalls = stats.total_recall_count ?? 0;
-        const score = Math.round((stats.quality_score ?? 0) * 100);
-        const tokensSaved = recalls * 1200;
-        const costSaved = (tokensSaved * 0.000003).toFixed(2);
-        const level = lessons === 0 ? 'Intern 🌱' :
-            lessons < 10 ? 'Junior Dev 🔧' :
-                lessons < 30 ? 'Mid Dev ⚡' :
-                    lessons < 60 ? 'Senior Dev 🧠' :
-                        lessons < 100 ? 'Staff Eng 🚀' : 'Principal Eng 🏆';
-        console.log('');
-        console.log('┌─────────────────────────────────────────────────────────────┐');
-        console.log('│  🧠 My AI Brain  ·  powered by \x1b[35mcachly.dev\x1b[0m                   │');
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log(`│  Lessons stored : \x1b[33m${String(lessons).padEnd(8)}\x1b[0m  Brain level: \x1b[32m${level.padEnd(18)}\x1b[0m│`);
-        console.log(`│  Total recalls  : \x1b[36m${String(recalls).padEnd(8)}\x1b[0m  Quality score: \x1b[32m${String(score).padEnd(3)}%\x1b[0m              │`);
-        console.log(`│  Tokens saved   : \x1b[32m${String((tokensSaved / 1000).toFixed(0) + 'K').padEnd(8)}\x1b[0m  Cost saved: \x1b[32m$${costSaved.padEnd(20)}\x1b[0m│`);
-        console.log('├─────────────────────────────────────────────────────────────┤');
-        console.log('│  Works with: Claude Code · Cursor · Windsurf · Copilot      │');
-        console.log('│  Free · GDPR · German servers                                │');
-        console.log('│  \x1b[35mnpx @cachly-dev/mcp-server@latest setup\x1b[0m                     │');
-        console.log('└─────────────────────────────────────────────────────────────┘');
-        console.log('');
-        // Tweet text
-        const shareUrl = 'https://cachly.dev?ref=share&utm_source=x&utm_medium=social&utm_campaign=cli-share';
-        const tweet = `🧠 My AI coding assistant now has persistent memory.\n\n${lessons} lessons stored · ${recalls} recalls · ${level}\n\nFix a bug once → AI remembers forever. Across Claude Code, Cursor, Windsurf, Copilot.\n\n${shareUrl}\n\n#AIMemory #ClaudeCode #Cursor #DeveloperTools`;
-        console.log('  \x1b[1m📋 Share on Twitter/X (copy this):\x1b[0m');
-        console.log('  ─────────────────────────────────────');
-        console.log(tweet.split('\n').map(l => `  ${l}`).join('\n'));
-        console.log('  ─────────────────────────────────────');
-        console.log('');
-        console.log('  \x1b[2mPro tip: add a screenshot of your Brain panel for 3x more engagement\x1b[0m');
-        console.log('  \x1b[2mAlso add a live badge to your README:\x1b[0m');
-        console.log(`  \x1b[90m  npx @cachly-dev/mcp-server@latest badge\x1b[0m`);
-        console.log('');
-    }
-    catch (e) {
-        console.log(`\n❌ Could not fetch stats: ${e.message}\n`);
-        process.exit(1);
-    }
-    process.exit(0);
-}
-// ── CLI: cachly badge ─────────────────────────────────────────────────────────
-// Outputs the Markdown + HTML snippet for embedding a live Brain lesson-count
-// badge in any README or website. Badge SVG served by cachly API (public, no auth).
-if (process.argv[2] === 'badge') {
-    const instanceId = process.env.CACHLY_BRAIN_INSTANCE_ID ?? '';
-    if (!instanceId) {
-        console.log('\n⚠️  CACHLY_BRAIN_INSTANCE_ID must be set.');
-        console.log('   Run: npx @cachly-dev/mcp-server@latest setup  (takes 30 seconds)\n');
-        process.exit(1);
-    }
-    const badgeUrl = `${API_URL}/api/v1/badge/${instanceId}`;
-    const targetUrl = 'https://cachly.dev';
-    const markdown = `[![cachly Brain](${badgeUrl})](${targetUrl})`;
-    const htmlBadge = `<a href="${targetUrl}"><img src="${badgeUrl}" alt="cachly Brain" /></a>`;
-    console.log('');
-    console.log('\x1b[35m  ╔═══════════════════════════════════════════════════════╗\x1b[0m');
-    console.log('\x1b[35m  ║\x1b[0m  \x1b[1m🧠 cachly Brain Badge\x1b[0m                              \x1b[35m║\x1b[0m');
-    console.log('\x1b[35m  ╚═══════════════════════════════════════════════════════╝\x1b[0m');
-    console.log('');
-    console.log('  Paste into your README.md:');
-    console.log('');
-    console.log(`  \x1b[32m${markdown}\x1b[0m`);
-    console.log('');
-    console.log('  ─────────────────────────────────────────────────────');
-    console.log('  Or paste into HTML:');
-    console.log('');
-    console.log(`  \x1b[36m${htmlBadge}\x1b[0m`);
-    console.log('');
-    console.log('  ─────────────────────────────────────────────────────');
-    console.log('  Badge URL (live, updates every hour):');
-    console.log(`  \x1b[90m${badgeUrl}\x1b[0m`);
-    console.log('');
-    console.log('  \x1b[2mThe badge shows your current lesson count — no auth required,');
-    console.log('  safe to embed in public repos. Updates hourly.\x1b[0m');
-    console.log('');
-    process.exit(0);
-}
-// ── CLI: no-args splash screen ────────────────────────────────────────────────
-// When run with no recognized subcommand, show a compelling pitch + help.
-if (!process.argv[2] && process.stdout.isTTY) {
-    console.log('');
-    console.log('\x1b[35m  ╔═══════════════════════════════════════════════════════╗\x1b[0m');
-    console.log('\x1b[35m  ║\x1b[0m  \x1b[1m🧠 cachly — Persistent AI Memory for Developers\x1b[0m   \x1b[35m║\x1b[0m');
-    console.log('\x1b[35m  ╚═══════════════════════════════════════════════════════╝\x1b[0m');
-    console.log('');
-    console.log('  Your AI forgets everything when a session ends.');
-    console.log('  cachly gives it a brain that survives forever.');
-    console.log('');
-    console.log('  \x1b[1mCommands:\x1b[0m');
-    console.log('  \x1b[32m  npx @cachly-dev/mcp-server@latest demo\x1b[0m     ← Start here (no account)');
-    console.log('  \x1b[32m  npx @cachly-dev/mcp-server@latest setup\x1b[0m    ← Wire up your AI editors');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest health\x1b[0m   ← Check everything works');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest digest\x1b[0m   ← Weekly Brain summary');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest share\x1b[0m    ← Share your Brain stats');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest badge\x1b[0m    ← README badge for your Brain');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest invite\x1b[0m   ← Invite a teammate');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest join <token>\x1b[0m ← Accept a Brain invite');
-    console.log('  \x1b[36m  npx @cachly-dev/mcp-server@latest upgrade\x1b[0m  ← Check for updates');
-    console.log('');
-    console.log('  \x1b[90mWorks with: Claude Code · Cursor · Windsurf · GitHub Copilot · Cline · Zed\x1b[0m');
-    console.log('  \x1b[90mFree forever · GDPR · German servers · 89 MCP tools\x1b[0m');
-    console.log('');
-    process.exit(0);
-}
 // ── CLI: cachly init ──────────────────────────────────────────────────────────
 // Usage: npx @cachly-dev/mcp-server init --instance-id <id> --api-key <key> [--editor claude|cursor|windsurf|copilot|continue] [--project-dir /path]
 if (process.argv[2] === 'init') {
@@ -1507,10 +869,8 @@ if (process.argv[2] === 'init') {
     const configFile = EDITOR_FILES[editor] ?? '.mcp.json';
     const configPath = resolve(projectDir, configFile);
     await mkdir(dirname(configPath), { recursive: true });
-    const { existsSync: exInit } = await import('node:fs');
-    const merged = await mergeMcpConfig(configPath, apiKey, instanceId, editor, { readFile, existsSync: exInit });
-    await writeFile(configPath, merged, 'utf-8');
-    console.log(`\n✅ ${exInit(configPath) ? 'Updated' : 'Written'}: ${configFile}`);
+    await writeFile(configPath, buildMcpConfig(apiKey, instanceId, editor), 'utf-8');
+    console.log(`\n✅ Written: ${configFile}`);
     // Always write CLAUDE.md (idempotent — safe to run multiple times)
     const result = await writeClaudeMd(projectDir, instanceId);
     const action = result === 'updated' ? '✅ Updated' : result === 'appended' ? '✅ Appended to' : '✅ Written';
@@ -1557,208 +917,7 @@ if (process.argv[2] === 'init') {
     }
     catch { /* non-critical — git hook is a best-effort feature */ }
     console.log(`\n🧠 Cachly AI Brain configured for ${editor === 'claude' ? 'Claude Code' : editor}!`);
-    console.log(`   Restart your editor — the \`cachly\` MCP tools will appear.`);
-    console.log(`\n   📛 Add a live badge to your README:`);
-    console.log(`      npx @cachly-dev/mcp-server@latest badge\n`);
-    process.exit(0);
-}
-// ── CLI: cachly health ────────────────────────────────────────────────────────
-// Usage: npx @cachly-dev/mcp-server@latest health
-// Checks: JWT valid, Brain API reachable, editor configs found, git hook present.
-if (process.argv[2] === 'health') {
-    const { existsSync } = await import('node:fs');
-    const { readFile } = await import('node:fs/promises');
-    const { resolve, join: pJoin } = await import('node:path');
-    const cwd = process.cwd();
-    let passed = 0;
-    let failed = 0;
-    const ok = (msg) => { console.log(`  ✅ ${msg}`); passed++; };
-    const warn = (msg) => { console.log(`  ⚠️  ${msg}`); };
-    const fail = (msg) => { console.log(`  ❌ ${msg}`); failed++; };
-    console.log('\n🧠 cachly health check\n');
-    // ── 1. JWT token ────────────────────────────────────────────────────────────
-    console.log('🔑 Auth token');
-    const jwt = process.env.CACHLY_JWT ?? '';
-    if (!jwt) {
-        fail('CACHLY_JWT not set — run: npx @cachly-dev/mcp-server@latest setup');
-    }
-    else {
-        try {
-            const parts = jwt.split('.');
-            if (parts.length !== 3)
-                throw new Error('not a JWT');
-            const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf-8'));
-            const expMs = payload.exp ? payload.exp * 1000 : null;
-            const minsLeft = expMs ? Math.floor((expMs - Date.now()) / 60_000) : null;
-            if (expMs && expMs < Date.now()) {
-                fail(`JWT expired ${Math.abs(minsLeft)} minute(s) ago — get a new one: https://cachly.dev/setup-ai`);
-            }
-            else if (minsLeft !== null && minsLeft < 30) {
-                warn(`JWT expires in ${minsLeft} minute(s) — refresh soon at https://cachly.dev/setup-ai`);
-            }
-            else {
-                ok(`JWT valid${minsLeft !== null ? ` (expires in ${Math.floor(minsLeft / 60)}h ${minsLeft % 60}m)` : ''}`);
-            }
-        }
-        catch {
-            fail('CACHLY_JWT format invalid (expected JWT with 3 parts)');
-        }
-    }
-    // ── 2. Brain API reachability ───────────────────────────────────────────────
-    console.log('\n🌐 Brain API');
-    const apiUrl = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
-    try {
-        const res = await fetch(`${apiUrl}/health`, { signal: AbortSignal.timeout(5000) });
-        if (res.ok) {
-            const body = await res.json();
-            ok(`${apiUrl} reachable (status: ${body.status ?? 'ok'})`);
-        }
-        else if (res.status === 401 || res.status === 403) {
-            ok(`${apiUrl} reachable (auth required — expected)`);
-        }
-        else {
-            fail(`${apiUrl}/health returned HTTP ${res.status}`);
-        }
-    }
-    catch (e) {
-        fail(`${apiUrl} unreachable — ${e.message}`);
-    }
-    // ── 3. Brain instance ───────────────────────────────────────────────────────
-    console.log('\n🧠 Brain instance');
-    const instanceId = process.env.CACHLY_BRAIN_INSTANCE_ID ?? '';
-    if (!instanceId) {
-        warn('CACHLY_BRAIN_INSTANCE_ID not set — will auto-resolve on first tool call');
-    }
-    else if (jwt) {
-        try {
-            const instRes = await fetch(`${apiUrl}/api/v1/instances/${instanceId}`, {
-                headers: { Authorization: `Bearer ${jwt}`, Accept: 'application/json' },
-                signal: AbortSignal.timeout(5000),
-            });
-            if (instRes.ok) {
-                const inst = await instRes.json();
-                if (inst.status === 'running') {
-                    ok(`Instance "${inst.name}" (${instanceId.slice(0, 8)}…) is running`);
-                    // Attempt actual Redis PING to verify connectivity end-to-end
-                    console.log('\n🔌 Redis connectivity');
-                    if (inst.host && inst.port) {
-                        try {
-                            let pingPassword;
-                            let pingTls = inst.tls_enabled !== false;
-                            try {
-                                const connRes = await fetch(`${apiUrl}/api/v1/instances/${instanceId}/connection`, {
-                                    headers: { Authorization: `Bearer ${jwt}`, Accept: 'application/json' },
-                                    signal: AbortSignal.timeout(5000),
-                                });
-                                if (connRes.ok) {
-                                    const conn = await connRes.json();
-                                    pingPassword = conn.password;
-                                    pingTls = conn.tls_enabled !== false;
-                                }
-                            }
-                            catch { /* proceed without password */ }
-                            const pingClient = new Redis({
-                                host: inst.host, port: inst.port,
-                                password: pingPassword,
-                                ...(pingTls ? { tls: {} } : {}),
-                                lazyConnect: true, connectTimeout: 5000, retryStrategy: () => null,
-                            });
-                            await pingClient.connect();
-                            const pong = await pingClient.ping();
-                            pingClient.disconnect();
-                            if (pong === 'PONG') {
-                                ok(`Redis PING → PONG (${inst.host}:${inst.port})`);
-                            }
-                            else {
-                                warn(`Redis responded but not PONG: ${pong}`);
-                            }
-                        }
-                        catch (pingErr) {
-                            fail(`Redis unreachable — ${pingErr.message}`);
-                        }
-                    }
-                    else {
-                        warn('Instance has no host/port yet');
-                    }
-                }
-                else {
-                    warn(`Instance "${inst.name}" status: ${inst.status}`);
-                }
-            }
-            else {
-                fail(`Instance ${instanceId.slice(0, 8)}… not found (HTTP ${instRes.status})`);
-            }
-        }
-        catch (e) {
-            fail(`Could not check instance — ${e.message}`);
-        }
-    }
-    // ── 4. Editor configs ───────────────────────────────────────────────────────
-    console.log('\n🛠  Editor configs (project dir)');
-    const editorConfigs = [
-        { editor: 'Claude Code', path: '.mcp.json' },
-        { editor: 'Cursor', path: '.cursor/mcp.json' },
-        { editor: 'Windsurf', path: '.windsurf/mcp.json' },
-        { editor: 'Copilot / Cline', path: '.vscode/mcp.json' },
-        { editor: 'Zed', path: '.zed/settings.json' },
-        { editor: 'Continue.dev', path: '.continue/config.json' },
-    ];
-    let configsFound = 0;
-    for (const { editor, path } of editorConfigs) {
-        const fullPath = resolve(cwd, path);
-        if (existsSync(fullPath)) {
-            try {
-                const content = await readFile(fullPath, 'utf-8');
-                const hasCachly = content.includes('@cachly-dev/mcp-server') || content.includes('cachly');
-                if (hasCachly) {
-                    ok(`${editor}: ${path}`);
-                    configsFound++;
-                }
-                else {
-                    warn(`${editor}: ${path} exists but cachly not found inside`);
-                }
-            }
-            catch {
-                warn(`${editor}: ${path} exists but could not read`);
-            }
-        }
-    }
-    if (configsFound === 0) {
-        fail('No editor MCP configs found — run: npx @cachly-dev/mcp-server@latest setup');
-    }
-    // ── 5. Git hook ─────────────────────────────────────────────────────────────
-    console.log('\n🪝 Git hook (ambient learning)');
-    const hookPath = resolve(cwd, '.git', 'hooks', 'post-commit');
-    if (!existsSync(resolve(cwd, '.git'))) {
-        warn('Not in a git repository — skip');
-    }
-    else if (existsSync(hookPath)) {
-        try {
-            const hook = await readFile(hookPath, 'utf-8');
-            if (hook.includes('cachly')) {
-                ok('.git/hooks/post-commit (cachly CLS hook present)');
-            }
-            else {
-                warn('.git/hooks/post-commit exists but cachly hook not found — run setup to add it');
-            }
-        }
-        catch {
-            warn('.git/hooks/post-commit exists but could not read');
-        }
-    }
-    else {
-        warn('.git/hooks/post-commit not found — run: npx @cachly-dev/mcp-server@latest setup');
-    }
-    // ── Summary ─────────────────────────────────────────────────────────────────
-    console.log(`\n${'─'.repeat(40)}`);
-    if (failed === 0) {
-        console.log(`✅ All checks passed (${passed} ok)\n`);
-    }
-    else {
-        console.log(`❌ ${failed} check(s) failed, ${passed} passed\n`);
-        console.log(`💡 Fix issues with: npx @cachly-dev/mcp-server@latest setup\n`);
-        process.exit(1);
-    }
+    console.log(`   Restart your editor — the \`cachly\` MCP tools will appear.\n`);
     process.exit(0);
 }
 // ── CLI: cachly setup (interactive — no flags required) ───────────────────────
@@ -1768,7 +927,6 @@ if (process.argv[2] === 'setup') {
     const { existsSync } = await import('node:fs');
     const { resolve, dirname } = await import('node:path');
     const { createInterface } = await import('node:readline');
-    sendFunnelEvent('setup_started');
     // --yes / -y → non-interactive mode (skips all prompts, picks defaults)
     const nonInteractive = process.argv.includes('--yes') || process.argv.includes('-y');
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -2015,23 +1173,12 @@ if (process.argv[2] === 'setup') {
     const editorsToSetup = detected;
     console.log(`Step 3: Configuring for: ${editorsToSetup.map(editorLabel).join(', ')}\n`);
     // ── Step 4: Write editor configs (project-level) ─────────────────────────
-    // Uses mergeMcpConfig to preserve all existing MCP servers — only adds/updates
-    // the cachly entry without touching filesystem, github, or other servers.
-    const { existsSync: exSetup } = await import('node:fs');
     for (const editor of editorsToSetup) {
         const configFile = EDITOR_FILES[editor] ?? '.mcp.json';
         const configPath = resolve(cwd, configFile);
-        try {
-            await mkdir(dirname(configPath), { recursive: true });
-            const wasExisting = exSetup(configPath);
-            const merged = await mergeMcpConfig(configPath, token, instance.id, editor, { readFile, existsSync: exSetup });
-            await writeFile(configPath, merged, 'utf-8');
-            console.log(`✅ ${wasExisting ? 'Updated' : 'Written'}: ${configFile}`);
-        }
-        catch (writeErr) {
-            console.log(`⚠️  Could not write ${configFile}: ${writeErr.message}`);
-            console.log(`   Fix permissions or run with sudo, then re-run setup.`);
-        }
+        await mkdir(dirname(configPath), { recursive: true });
+        await writeFile(configPath, buildMcpConfig(token, instance.id, editor), 'utf-8');
+        console.log(`✅ Written: ${configFile}`);
     }
     // ── Step 4b: Write global Claude Code config (~/.claude/mcp.json) ─────────
     // Merges cachly into the existing global config so it works in every project,
@@ -2154,9 +1301,7 @@ if (process.argv[2] === 'setup') {
     }
     console.log(`\n🧠  Done! Restart your editor — the \`cachly\` MCP tools will appear.`);
     console.log(`   Your AI now has persistent memory across every session.\n`);
-    console.log(`   Dashboard: https://cachly.dev/instances/${instance.id}`);
-    console.log(`\n   📛 Add a live badge to your README:`);
-    console.log(`      npx @cachly-dev/mcp-server@latest badge\n`);
+    console.log(`   Dashboard: https://cachly.dev/instances/${instance.id}\n`);
     // ── Step 7: Email opt-in (non-blocking — at the very end) ────────────────
     if (!nonInteractive) {
         const email = await ask('   📬 Stay in the loop? Email for release notes [Enter to skip]: ');
@@ -2252,9 +1397,7 @@ if (process.argv[2] === 'index') {
 // ── Start ─────────────────────────────────────────────────────────────────────
 // Warn on stderr when credentials are missing so the user sees a clear
 // actionable message in their editor's MCP log instead of silent failures.
-// Skip for CLI commands that intentionally run without credentials.
-const _cliNoAuthCommands = ['demo', 'share', 'health', 'setup', 'init', 'digest', 'invite', 'badge', 'join', 'upgrade'];
-if (!JWT && !_cliNoAuthCommands.includes(process.argv[2] ?? '') && !(!process.argv[2] && process.stdout.isTTY)) {
+if (!JWT) {
     process.stderr.write('\n' +
         '╔══════════════════════════════════════════════════════════════════╗\n' +
         '║  🧠  cachly AI Brain — Setup required                           ║\n' +