@cachly-dev/mcp-server 0.10.97 → 0.10.99

package/dist/src/index.d.ts

@@ -11,3 +11,11 @@ export declare function mergeMcpConfig(configPath: string, apiKey: string, insta
     existsSync: (p: string) => boolean;
 }): Promise<string>;
 export declare function buildClaudeMdBlock(instanceId: string): string;
+/**
+ * Schreibt das Brain-Protokoll in alle relevanten Instruction-Dateien:
+ * - CLAUDE.md
+ * - AGENTS.md
+ * - .github/copilot-instructions.md
+ * Idempotent, Marker-basiert.
+ */
+export declare function writeInstructions(projectDir: string, instanceId: string): Promise<Record<string, 'written' | 'updated' | 'appended'>>;

package/dist/src/index.js

@@ -3,6 +3,7 @@ import { jwtExpiryMs, checkJwt, handleApiError, diagnoseAuth, planAuthHeal, read
 import { handleTcoTool } from './handlers/tco.js';
 import { notify } from './notifier.js';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 // True only when this file is the entry point (not imported by tests or other modules).
 const _isMain = process.argv[1] != null &&
     (process.argv[1] === fileURLToPath(import.meta.url) ||
@@ -65,7 +66,26 @@ 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.88';
+// Resolve the package version at runtime from package.json so the telemetry
+// `version` field always matches the published npm version. A hardcoded constant
+// silently drifted (0.10.88 vs published 0.10.98), making release adoption
+// impossible to track. Paths cover both prod (dist/src/index.js → ../../) and
+// dev (src/index.ts → ../). Falls back to a literal if resolution fails.
+const CURRENT_VERSION = (() => {
+    try {
+        const req = createRequire(import.meta.url);
+        for (const rel of ['../../package.json', '../package.json']) {
+            try {
+                const pkg = req(rel);
+                if (pkg.name === '@cachly-dev/mcp-server' && pkg.version)
+                    return pkg.version;
+            }
+            catch { /* try next candidate */ }
+        }
+    }
+    catch { /* fall through to literal */ }
+    return '0.10.99';
+})();
 // 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.
@@ -336,20 +356,26 @@ async function selfHealAuth() {
 }
 let _deviceFlow = null;
 async function startDeviceFlow() {
-    // Try the API proxy first (more reliable than direct Keycloak endpoint)
+    // Try the cachly API device flow first. It returns a long-lived API key directly
+    // on poll (no separate JWT→key exchange needed) and is served at the ROOT paths
+    // /auth/device + /auth/device/token (NOT under /api/v1). Requires VALKEY_L1_URL on
+    // the API; when unset the API returns 503 and we fall through to Keycloak below.
     try {
-        const res = await fetch(`${API_URL}/api/v1/auth/device/code`, {
+        const res = await fetch(`${API_URL}/auth/device`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ client_id: 'cachly-mcp-cli' }),
+            body: JSON.stringify({}),
             signal: AbortSignal.timeout(8000),
         });
         if (res.ok) {
             const data = await res.json();
+            // Append the user_code so the web page (cachly.dev/device?code=…) auto-submits.
+            const base = data.verification_uri || 'https://cachly.dev/device';
+            const verifyUrl = `${base}${base.includes('?') ? '&' : '?'}code=${encodeURIComponent(data.user_code)}`;
             return {
                 deviceCode: data.device_code,
                 userCode: data.user_code,
-                verifyUrl: data.verification_uri,
+                verifyUrl,
                 pollInterval: (data.interval ?? 5) * 1000,
                 deadline: Date.now() + 10 * 60 * 1000,
                 polling: false,
@@ -385,12 +411,12 @@ async function startDeviceFlow() {
 async function pollDeviceFlow(flow) {
     if (Date.now() > flow.deadline)
         return 'expired';
-    // Try API proxy first, then direct Keycloak as fallback
+    // Try the cachly API device flow first, then direct Keycloak as fallback.
     const tryProxy = async () => {
-        const res = await fetch(`${API_URL}/api/v1/auth/device/token`, {
+        const res = await fetch(`${API_URL}/auth/device/token`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ device_code: flow.deviceCode, client_id: 'cachly-mcp-cli' }),
+            body: JSON.stringify({ device_code: flow.deviceCode }),
             signal: AbortSignal.timeout(8000),
         });
         if (!res.ok)
@@ -783,7 +809,7 @@ async function handleTool(name, args) {
                 '',
                 'After sign-in: call **any tool again** — your Brain activates instantly.',
                 '',
-                '✨ Free forever · No credit card · 120 MCP tools · GDPR · EU servers',
+                '✨ Free forever · No credit card · 121 MCP tools · GDPR · EU servers',
             ].join('\n');
         }
         // Device flow unavailable (network issue) — fall back to manual setup
@@ -1378,25 +1404,43 @@ Report predicted failure risks to the user before proceeding.
 Never commit code that does not compile. Run \`tsc --noEmit\` / \`go build ./...\` before every commit.
 ${CLAUDE_MD_MARKER_END}`;
 }
-async function writeClaudeMd(projectDir, instanceId) {
-    const { writeFile, appendFile, readFile } = await import('node:fs/promises');
+/**
+ * Schreibt das Brain-Protokoll in alle relevanten Instruction-Dateien:
+ * - CLAUDE.md
+ * - AGENTS.md
+ * - .github/copilot-instructions.md
+ * Idempotent, Marker-basiert.
+ */
+export async function writeInstructions(projectDir, instanceId) {
+    const { writeFile, appendFile, readFile, mkdir } = await import('node:fs/promises');
     const { existsSync } = await import('node:fs');
-    const { resolve } = await import('node:path');
-    const claudeMdPath = resolve(projectDir, 'CLAUDE.md');
+    const { resolve, dirname } = await import('node:path');
+    const files = [
+        resolve(projectDir, 'CLAUDE.md'),
+        resolve(projectDir, 'AGENTS.md'),
+        resolve(projectDir, '.github', 'copilot-instructions.md'),
+    ];
     const block = '\n' + buildClaudeMdBlock(instanceId) + '\n';
-    if (existsSync(claudeMdPath)) {
-        const existing = await readFile(claudeMdPath, 'utf-8');
-        if (existing.includes(CLAUDE_MD_MARKER_START)) {
-            // Idempotent update: replace existing block (new instance-id, refreshed content)
-            const updated = existing.replace(new RegExp(`${CLAUDE_MD_MARKER_START}[\\s\\S]*?${CLAUDE_MD_MARKER_END}`), buildClaudeMdBlock(instanceId));
-            await writeFile(claudeMdPath, updated, 'utf-8');
-            return 'updated';
-        }
-        await appendFile(claudeMdPath, block, 'utf-8');
-        return 'appended';
-    }
-    await writeFile(claudeMdPath, block.trimStart(), 'utf-8');
-    return 'written';
+    const results = {};
+    for (const file of files) {
+        await mkdir(dirname(file), { recursive: true });
+        if (existsSync(file)) {
+            const existing = await readFile(file, 'utf-8');
+            if (existing.includes(CLAUDE_MD_MARKER_START)) {
+                // Idempotent update: replace existing block
+                const updated = existing.replace(new RegExp(`${CLAUDE_MD_MARKER_START}[\s\S]*?${CLAUDE_MD_MARKER_END}`), buildClaudeMdBlock(instanceId));
+                await writeFile(file, updated, 'utf-8');
+                results[file] = 'updated';
+                continue;
+            }
+            await appendFile(file, block, 'utf-8');
+            results[file] = 'appended';
+            continue;
+        }
+        await writeFile(file, block.trimStart(), 'utf-8');
+        results[file] = 'written';
+    }
+    return results;
 }
 // ── CLI: cachly digest ────────────────────────────────────────────────────────
 // Usage: npx @cachly-dev/mcp-server@latest digest
@@ -2212,7 +2256,7 @@ if (!process.argv[2] && process.stdout.isTTY) {
     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 · 120 MCP tools\x1b[0m');
+    console.log('  \x1b[90mFree forever · GDPR · German servers · 121 MCP tools\x1b[0m');
     console.log('');
     process.exit(0);
 }
@@ -2274,10 +2318,15 @@ if (process.argv[2] === 'init') {
     else {
         console.log(`\n✓  Already configured: ${configFile} (no change)`);
     }
-    // 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';
-    console.log(`${action}: CLAUDE.md`);
+    // Always write the brain protocol to all instruction files (idempotent —
+    // safe to run multiple times). Covers CLAUDE.md, AGENTS.md and Copilot so any
+    // agent the user runs arrives pre-briefed.
+    const results = await writeInstructions(projectDir, instanceId);
+    for (const [path, action] of Object.entries(results)) {
+        const verb = action === 'updated' ? '✅ Updated' : action === 'appended' ? '✅ Appended to' : '✅ Written';
+        const name = path.split(/[\\/]/).pop() ?? path;
+        console.log(`${verb}: ${name}`);
+    }
     // ── CLS Phase 4: Auto-install git post-commit hook ─────────────────────────
     try {
         const { existsSync } = await import('node:fs');
@@ -3028,10 +3077,12 @@ if (process.argv[2] === 'setup' || _isAutopilotCli) {
         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);
-    const mdLabel = mdResult === 'updated' ? '✅ Updated' : mdResult === 'appended' ? '✅ Appended to' : '✅ Written';
-    console.log(`${mdLabel}: CLAUDE.md\n`);
+    // ── Step 5: Instructions für alle Vendors (immer, idempotent) ─────────────
+    const instrResults = await writeInstructions(cwd, instance.id);
+    for (const [file, res] of Object.entries(instrResults)) {
+        const label = res === 'updated' ? '✅ Updated' : res === 'appended' ? '✅ Appended to' : '✅ Written';
+        console.log(`${label}: ${file}`);
+    }
     // ── Step 5b: Bootstrap Brain from git history ─────────────────────────────
     // Pre-populates the Brain with real lessons so the first session_start shows
     // actual project knowledge instead of an empty brain.