@cachly-dev/mcp-server 0.10.87 → 0.10.89

package/dist/src/index.d.ts

@@ -1,3 +1,13 @@
 #!/usr/bin/env node
 import { tokenize, splitMultiQuery, levenshtein, recencyBoost, extractTimestamp, STOPWORDS, katakanaToRomaji, arabicLightStem, expandCrossLingual, CROSS_LINGUAL_MAP } from './search.js';
 export { tokenize, splitMultiQuery, levenshtein, recencyBoost, extractTimestamp, STOPWORDS, katakanaToRomaji, arabicLightStem, expandCrossLingual, CROSS_LINGUAL_MAP };
+export declare const EDITOR_FILES: Record<string, string>;
+export declare const CLAUDE_MD_MARKER_START = "<!-- cachly-brain-start -->";
+export declare const CLAUDE_MD_MARKER_END = "<!-- cachly-brain-end -->";
+export declare function buildServerEnv(apiKey: string, instanceId: string): Record<string, string>;
+export declare function buildMcpConfig(apiKey: string, instanceId: string, editor: string): string;
+export declare function mergeMcpConfig(configPath: string, apiKey: string, instanceId: string, editor: string, fsOps: {
+    readFile: (p: string, enc: BufferEncoding) => Promise<string>;
+    existsSync: (p: string) => boolean;
+}): Promise<string>;
+export declare function buildClaudeMdBlock(instanceId: string): string;

package/dist/src/index.js

@@ -65,7 +65,7 @@ import { Redis } from 'ioredis';
 let 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.87';
+const CURRENT_VERSION = '0.10.88';
 // Max time to wait for a freshly-provisioned instance to become "running" before
 // giving up. Free-tier provisioning in high-latency regions can take 45–90s, so the
 // old hard-coded 25s caused spurious "instance_not_reachable" on first run.
@@ -792,7 +792,7 @@ async function handleTool(name, args) {
             '',
             'Run the setup wizard once in your terminal:',
             '   ```',
-            '   npx @cachly-dev/mcp-server@latest setup',
+            '   npx @cachly-dev/mcp-server@latest autopilot',
             '   ```',
             '',
             'Or get your API key at: https://cachly.dev/setup-ai',
@@ -1213,7 +1213,7 @@ process.on('unhandledRejection', (reason) => {
     process.stderr.write(`[cachly-mcp] unhandledRejection: ${msg}\n`);
 });
 // ── CLI helpers ───────────────────────────────────────────────────────────────
-const EDITOR_FILES = {
+export const EDITOR_FILES = {
     claude: '.mcp.json',
     cursor: '.cursor/mcp.json',
     windsurf: '.windsurf/mcp.json',
@@ -1222,8 +1222,8 @@ const EDITOR_FILES = {
     cline: '.vscode/mcp.json', // Cline respects VS Code project MCP config
     zed: '.zed/settings.json', // Zed project-level context_servers
 };
-const CLAUDE_MD_MARKER_START = '<!-- cachly-brain-start -->';
-const CLAUDE_MD_MARKER_END = '<!-- cachly-brain-end -->';
+export const CLAUDE_MD_MARKER_START = '<!-- cachly-brain-start -->';
+export const CLAUDE_MD_MARKER_END = '<!-- cachly-brain-end -->';
 const DEFAULT_API_URL = 'https://api.cachly.dev';
 // Build the env block written into an editor's MCP config. Self-hosting is
 // first-class: if the operator runs setup/init against their own backend
@@ -1231,13 +1231,13 @@ const DEFAULT_API_URL = 'https://api.cachly.dev';
 // the editor-launched server talks to the self-hosted instance — not api.cachly.dev.
 // For the default cloud backend we OMIT CACHLY_API_URL to keep configs clean (the
 // binary already defaults to it).
-function buildServerEnv(apiKey, instanceId) {
+export function buildServerEnv(apiKey, instanceId) {
     const env = { CACHLY_JWT: apiKey, CACHLY_BRAIN_INSTANCE_ID: instanceId };
     if (API_URL && API_URL !== DEFAULT_API_URL)
         env.CACHLY_API_URL = API_URL;
     return env;
 }
-function buildMcpConfig(apiKey, instanceId, editor) {
+export function buildMcpConfig(apiKey, instanceId, editor) {
     if (editor === 'continue') {
         return JSON.stringify({
             experimental: {
@@ -1274,7 +1274,7 @@ function buildMcpConfig(apiKey, instanceId, editor) {
 }
 // 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) {
+export async function mergeMcpConfig(configPath, apiKey, instanceId, editor, fsOps) {
     const cachlyEntry = {
         command: 'npx',
         args: ['-y', '@cachly-dev/mcp-server@latest'],
@@ -1320,7 +1320,7 @@ async function mergeMcpConfig(configPath, apiKey, instanceId, editor, fsOps) {
     existing['mcpServers'] = servers;
     return JSON.stringify(existing, null, 2);
 }
-function buildClaudeMdBlock(instanceId) {
+export function buildClaudeMdBlock(instanceId) {
     return `${CLAUDE_MD_MARKER_START}
 ## Cachly AI Brain — Always Active
 
@@ -1406,7 +1406,7 @@ if (process.argv[2] === 'digest') {
     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');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot\n');
         process.exit(1);
     }
     process.stdout.write('\n🧠 Fetching your weekly Brain digest...\n\n');
@@ -1495,7 +1495,7 @@ if (process.argv[2] === 'invite') {
     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');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot\n');
         process.exit(1);
     }
     try {
@@ -1742,7 +1742,7 @@ if (process.argv[2] === 'upgrade') {
             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('  \x1b[32m  npx @cachly-dev/mcp-server@latest autopilot\x1b[0m');
             console.log('');
             console.log('  \x1b[2m(npx always fetches the latest when @latest is specified)\x1b[0m');
             console.log('');
@@ -1905,7 +1905,7 @@ if (process.argv[2] === 'demo') {
     });
     const previewURL = `https://cachly.dev/preview?${previewParams.toString()}`;
     console.log('  \x1b[1mMake this permanent (free, 1–5 minutes):\x1b[0m');
-    console.log('  \x1b[32m$ npx @cachly-dev/mcp-server@latest setup\x1b[0m');
+    console.log('  \x1b[32m$ npx @cachly-dev/mcp-server@latest autopilot\x1b[0m');
     console.log('');
     console.log(`  \x1b[90m🔗 Shareable preview:\x1b[0m \x1b[36m${previewURL}\x1b[0m`);
     console.log('');
@@ -1922,7 +1922,7 @@ if (process.argv[2] === 'share') {
     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 1–5 minutes)\n');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot  (takes 1–5 minutes)\n');
         process.exit(1);
     }
     process.stdout.write('\n🧠 Fetching your Brain stats...\n');
@@ -1954,7 +1954,7 @@ if (process.argv[2] === 'share') {
         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('│  \x1b[35mnpx @cachly-dev/mcp-server@latest autopilot\x1b[0m                 │');
         console.log('└─────────────────────────────────────────────────────────────┘');
         console.log('');
         // Tweet text
@@ -1984,7 +1984,7 @@ if (process.argv[2] === 'publish') {
     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');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot\n');
         process.exit(1);
     }
     const titleIdx = process.argv.indexOf('--title');
@@ -2079,7 +2079,7 @@ 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 1–5 minutes)\n');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot  (takes 1–5 minutes)\n');
         process.exit(1);
     }
     const badgeUrl = `${API_URL}/api/v1/badge/${instanceId}`;
@@ -2176,7 +2176,7 @@ if (process.argv[2] === 'init') {
     }
     if (!instanceId || !apiKey) {
         console.error('\nUsage: npx @cachly-dev/mcp-server@latest init --instance-id <uuid> --api-key <cky_live_...> [--editor claude|cursor|windsurf|copilot|continue] [--project-dir /path] [--api-url https://your-self-hosted-backend]\n');
-        console.error('First time? Run the zero-config wizard (signs you in, auto-provisions): npx @cachly-dev/mcp-server@latest setup\n');
+        console.error('First time? Run the zero-config wizard (signs you in, auto-provisions): npx @cachly-dev/mcp-server@latest autopilot\n');
         console.error('Get your credentials from: https://cachly.dev/setup-ai\n');
         process.exit(1);
     }
@@ -2259,7 +2259,7 @@ if (process.argv[2] === 'status') {
     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');
+        console.log('   Run: npx @cachly-dev/mcp-server@latest autopilot\n');
         process.exit(1);
     }
     try {
@@ -2337,7 +2337,7 @@ if (process.argv[2] === 'health') {
     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');
+        fail('CACHLY_JWT not set — run: npx @cachly-dev/mcp-server@latest autopilot');
     }
     else if (jwt.startsWith('cky_')) {
         // Long-lived API key (the credential `setup` provisions). It is not a JWT and
@@ -2486,7 +2486,7 @@ if (process.argv[2] === 'health') {
         }
     }
     if (configsFound === 0) {
-        fail('No editor MCP configs found — run: npx @cachly-dev/mcp-server@latest setup');
+        fail('No editor MCP configs found — run: npx @cachly-dev/mcp-server@latest autopilot');
     }
     // ── 5. Git hook ─────────────────────────────────────────────────────────────
     console.log('\n🪝 Git hook (ambient learning)');
@@ -2509,7 +2509,7 @@ if (process.argv[2] === 'health') {
         }
     }
     else {
-        warn('.git/hooks/post-commit not found — run: npx @cachly-dev/mcp-server@latest setup');
+        warn('.git/hooks/post-commit not found — run: npx @cachly-dev/mcp-server@latest autopilot');
     }
     // ── 6. Embedding provider (BYOK) ─────────────────────────────────────────────
     console.log('\n🧬 Embedding provider (semantic search)');
@@ -2542,7 +2542,7 @@ if (process.argv[2] === 'health') {
     }
     else {
         console.log(`❌ ${failed} check(s) failed, ${passed} passed\n`);
-        console.log(`💡 Fix issues with: npx @cachly-dev/mcp-server@latest setup\n`);
+        console.log(`💡 Fix issues with: npx @cachly-dev/mcp-server@latest autopilot\n`);
         process.exit(1);
     }
     process.exit(0);
@@ -2732,7 +2732,7 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
                 sendFunnelEvent('device_flow_failed', { reason: 'non_interactive_no_key' });
                 console.error('\n   ⚠️  This terminal is non-interactive, so the key cannot be pasted here.');
                 console.error('   Get your key at the URL above, then set it and re-run setup:\n');
-                console.error('     \x1b[1mCACHLY_JWT=cky_live_xxx npx @cachly-dev/mcp-server@latest setup\x1b[0m\n');
+                console.error('     \x1b[1mCACHLY_JWT=cky_live_xxx npx @cachly-dev/mcp-server@latest autopilot\x1b[0m\n');
                 console.error('   Or add it to your editor\'s MCP config under env.CACHLY_JWT.\n');
                 rl.close();
                 process.exit(1);
@@ -2899,6 +2899,10 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
     // 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');
+    // Track config-write failures so the final summary tells the truth instead of
+    // always claiming "Brain is ready" even when a config never got written.
+    const configWriteFailures = [];
+    let configWriteSuccesses = 0;
     for (const editor of editorsToSetup) {
         const configFile = EDITOR_FILES[editor] ?? '.mcp.json';
         const configPath = resolve(cwd, configFile);
@@ -2908,10 +2912,13 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
             const merged = await mergeMcpConfig(configPath, token, instance.id, editor, { readFile, existsSync: exSetup });
             await writeFile(configPath, merged, 'utf-8');
             console.log(`✅ ${wasExisting ? 'Updated' : 'Written'}: ${configFile}`);
+            configWriteSuccesses++;
         }
         catch (writeErr) {
-            console.log(`⚠️  Could not write ${configFile}: ${writeErr.message}`);
+            const reason = writeErr.message;
+            console.log(`⚠️  Could not write ${configFile}: ${reason}`);
             console.log(`   Fix permissions or run with sudo, then re-run setup.`);
+            configWriteFailures.push({ file: configFile, reason });
         }
     }
     // ── Step 4b: Write global Claude Code config (~/.claude/mcp.json) ─────────
@@ -2935,9 +2942,12 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
         };
         await writeFile(globalClaudePath, JSON.stringify(globalConfig, null, 2), 'utf-8');
         console.log(`✅ Written: ~/.claude/mcp.json  (global — works in every project)`);
+        configWriteSuccesses++;
     }
     catch (e) {
-        console.log(`⚠️  Could not write ~/.claude/mcp.json: ${e.message}`);
+        const reason = e.message;
+        console.log(`⚠️  Could not write ~/.claude/mcp.json: ${reason}`);
+        configWriteFailures.push({ file: '~/.claude/mcp.json', reason });
     }
     // ── Step 5: CLAUDE.md (always — idempotent) ───────────────────────────────
     const mdResult = await writeClaudeMd(cwd, instance.id);
@@ -3135,15 +3145,51 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
         }
     }
     catch { /* non-critical */ }
-    // Setup reached the end successfully — close the funnel.
+    // Setup reached the end — close the funnel. Report config-write outcome so the
+    // weekly funnel can spot permission/path problems blocking activation.
     JWT = token;
     const setupElapsedS = Math.round((Date.now() - setupStartMs) / 1000);
-    sendFunnelEvent('setup_completed', { instance_id: instance.id, elapsed_s: setupElapsedS });
+    if (configWriteFailures.length > 0) {
+        sendFunnelEvent('setup_config_write_failed', {
+            instance_id: instance.id,
+            failed: configWriteFailures.length,
+            succeeded: configWriteSuccesses,
+        });
+    }
+    sendFunnelEvent('setup_completed', {
+        instance_id: instance.id,
+        elapsed_s: setupElapsedS,
+        config_failures: configWriteFailures.length,
+    });
+    if (configWriteFailures.length > 0 && configWriteSuccesses === 0) {
+        // Nothing got written — be honest, this is NOT "ready".
+        console.log('\n╔══════════════════════════════════════════════════════╗');
+        console.log('║  ⚠️   Setup incomplete — no editor config was written ║');
+        console.log('╚══════════════════════════════════════════════════════╝');
+        console.log('\n   Your Brain instance exists, but no editor knows about it yet.');
+        console.log('   Failed writes:');
+        for (const f of configWriteFailures)
+            console.log(`     • ${f.file} — ${f.reason}`);
+        console.log('\n   Fix the permissions above and re-run, or configure manually:');
+        console.log(`     CACHLY_JWT=${token.slice(0, 12)}… CACHLY_BRAIN_INSTANCE_ID=${instance.id}`);
+        console.log(`   Docs: https://cachly.dev/docs/mcp\n`);
+        rl.close();
+        await new Promise(r => setTimeout(r, 300));
+        process.exit(1);
+    }
     console.log('\n╔══════════════════════════════════════════════════════╗');
     console.log('║  🚀  Brain is ready.                                 ║');
     console.log(`║  ⏱️   Setup completed in ${String(setupElapsedS + 's').padEnd(5)} — restart your editor  ║`);
     console.log('║      and your AI arrives pre-briefed every session.  ║');
-    console.log('╚══════════════════════════════════════════════════════╝\n');
+    console.log('╚══════════════════════════════════════════════════════╝');
+    if (configWriteFailures.length > 0) {
+        // Partial success — some editors configured, some not. Tell the truth.
+        console.log('\n   ⚠️  Some editor configs could not be written (others succeeded):');
+        for (const f of configWriteFailures)
+            console.log(`     • ${f.file} — ${f.reason}`);
+        console.log('   Fix the permissions above and re-run setup to configure them too.');
+    }
+    console.log('');
     rl.close();
     // Give the fire-and-forget telemetry a moment to flush before exit.
     await new Promise(r => setTimeout(r, 300));
@@ -3281,9 +3327,9 @@ if (!JWT && !_cliNoAuthCommands.includes(process.argv[2] ?? '')) {
             '║                                                                  ║\n' +
             '║    👉  https://cachly.dev/setup-ai                              ║\n' +
             '║                                                                  ║\n' +
-            '║  Then run the interactive setup wizard:                         ║\n' +
+            '║  Then run the one-command setup wizard:                         ║\n' +
             '║                                                                  ║\n' +
-            '║    npx @cachly-dev/mcp-server@latest setup                      ║\n' +
+            '║    npx @cachly-dev/mcp-server@latest autopilot                  ║\n' +
             '║                                                                  ║\n' +
             '║  Free tier — no credit card required.                           ║\n' +
             '╚══════════════════════════════════════════════════════════════════╝\n' +
@@ -3297,7 +3343,7 @@ if (!JWT && !_cliNoAuthCommands.includes(process.argv[2] ?? '')) {
         // hint to stderr (shown in the editor's MCP log) and fall through so the
         // server starts and the zero-credential device flow can run on first tool call.
         process.stderr.write('\n🧠 cachly: no CACHLY_JWT set yet — call any cachly tool and a 10-second browser sign-in starts automatically.\n' +
-            '   (Or run once: npx @cachly-dev/mcp-server@latest setup)\n\n');
+            '   (Or run once: npx @cachly-dev/mcp-server@latest autopilot)\n\n');
     }
 }
 else {
@@ -3327,7 +3373,7 @@ if (!process.env.CACHLY_NO_UPDATE_CHECK) {
                 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`);
+                        `   Run: npx @cachly-dev/mcp-server@latest autopilot\n\n`);
                 }
             }
         }