@cachly-dev/mcp-server 0.9.7 → 0.9.8

package/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "HeinrichNebula"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "mcpName": "io.github.cachly-dev/cachly-mcp",
   "description": "Your AI forgets everything between sessions. cachly fixes that permanently. A causal brain that learns WHY things break — built from every bug fix, git commit, and CI run, without any explicit calls. Arrives pre-briefed each session. Predicts failures before they happen. Never re-researches the same problem. 63 MCP tools · Claude Code · Cursor · GitHub Copilot · Windsurf · Free tier · EU servers.",
   "type": "module",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cachly-dev/cachly-mcp",
-  "description": "Your AI forgets everything between sessions. cachly fixes that permanently. A causal brain that learns WHY things break — built from every bug fix, git commit, and CI run, without any explicit calls. Arrives pre-briefed each session. Predicts failures before they happen. Never re-researches the same problem. 63 MCP tools · Free tier · EU servers.",
+  "description": "Your AI forgets everything between sessions. cachly fixes that permanently. A causal brain that learns WHY things break — built from every bug fix, git commit, and CI run, without any explicit calls. Arrives pre-briefed each session. Predicts failures before they happen. Never re-researches the same problem. 67 MCP tools · Free tier · EU servers.",
   "repository": {
     "url": "https://github.com/cachly-dev/cachly-mcp",
     "source": "github"

package/src/index.ts

@@ -55,7 +55,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.9.7';
+const CURRENT_VERSION = '0.9.8';
 
 // ── Default Instance Resolution (for Smithery & single-credential setups) ────
 // When CACHLY_BRAIN_INSTANCE_ID is set, tools can omit the instance_id parameter.
@@ -1960,18 +1960,20 @@ async function keywordSearch(
   query: string,
   topK = 10,
 ): Promise<KeywordMatch[]> {
-  // ── Step 1: Collect and tokenize all documents ──
-  const allKeys: string[] = [];
-  for (const pattern of patterns) {
-    const stream = redis.scanStream({ match: pattern, count: 200 });
-    await new Promise<void>((resolve, reject) => {
+  // ── Step 1: Collect all matching keys — patterns scanned in parallel ──
+  const keyBatches = await Promise.all(patterns.map(pattern => {
+    const keys: string[] = [];
+    const stream = redis.scanStream({ match: pattern, count: 500 });
+    return new Promise<string[]>((resolve, reject) => {
       stream.on('data', (batch: string[]) => {
-        allKeys.push(...batch.filter((k: string) => !k.endsWith(':meta')));
+        keys.push(...batch.filter((k: string) => !k.endsWith(':meta')));
       });
-      stream.on('end', resolve);
+      stream.on('end', () => resolve(keys));
       stream.on('error', reject);
     });
-  }
+  }));
+  // Deduplicate across patterns (a key may match multiple globs)
+  const allKeys = [...new Set(keyBatches.flat())];
 
   if (allKeys.length === 0) return [];
 
@@ -2285,15 +2287,37 @@ async function getConnection(instance_id: string): Promise<Redis> {
 
 // ── API helper ────────────────────────────────────────────────────────────────
 
+function jwtExpiryMs(token: string): number | null {
+  try {
+    const parts = token.split('.');
+    if (parts.length !== 3) return null;
+    const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf-8')) as { exp?: number };
+    return payload.exp ? payload.exp * 1000 : null;
+  } catch { return null; }
+}
+
 async function apiFetch<T>(path: string, options: RequestInit = {}): Promise<T> {
   if (!JWT) {
     throw new McpError(
       ErrorCode.InvalidRequest,
-      'CACHLY_JWT env var not set. Get your API token from https://cachly.dev/settings'
+      'CACHLY_JWT env var not set.\n\nGet your token at https://cachly.dev/setup-ai and add it to your MCP config:\n  CACHLY_JWT=<your-token>'
+    );
+  }
+
+  // Detect token expiry before making the network call — gives a clearer error
+  const expMs = jwtExpiryMs(JWT);
+  if (expMs !== null && expMs < Date.now()) {
+    const expiredAt = new Date(expMs).toISOString();
+    throw new McpError(
+      ErrorCode.InvalidRequest,
+      `CACHLY_JWT expired at ${expiredAt}.\n\nGet a fresh token at https://cachly.dev/setup-ai and update CACHLY_JWT in your MCP config.`
     );
   }
+
+  const timeoutMs = Number(process.env.CACHLY_API_TIMEOUT_MS ?? 15_000);
   const res = await fetch(`${API_URL}${path}`, {
     ...options,
+    signal: AbortSignal.timeout(timeoutMs),
     headers: {
       'Content-Type': 'application/json',
       Authorization: `Bearer ${JWT}`,
@@ -2302,9 +2326,22 @@ async function apiFetch<T>(path: string, options: RequestInit = {}): Promise<T>
   });
   if (!res.ok) {
     const body = await res.json().catch(() => ({ error: res.statusText }));
+    const detail = (body as { error?: string }).error ?? res.statusText;
+    if (res.status === 401) {
+      throw new McpError(
+        ErrorCode.InvalidRequest,
+        `Authentication failed (401): ${detail}\n\nYour CACHLY_JWT may be expired or invalid. Get a fresh token at https://cachly.dev/setup-ai`
+      );
+    }
+    if (res.status === 403) {
+      throw new McpError(
+        ErrorCode.InvalidRequest,
+        `Access denied (403): ${detail}\n\nCheck that your CACHLY_JWT belongs to an account with access to this resource.`
+      );
+    }
     throw new McpError(
       ErrorCode.InternalError,
-      `cachly API error ${res.status}: ${(body as { error?: string }).error ?? res.statusText}`
+      `cachly API error ${res.status}: ${detail}`
     );
   }
   if (res.status === 204) return undefined as T;
@@ -10297,6 +10334,23 @@ if (!JWT) {
     '╚══════════════════════════════════════════════════════════════════╝\n' +
     '\n',
   );
+} else {
+  // Warn if the JWT is already expired or expiring within the hour.
+  const expMs = jwtExpiryMs(JWT);
+  if (expMs !== null) {
+    const minsLeft = Math.floor((expMs - Date.now()) / 60_000);
+    if (minsLeft <= 0) {
+      process.stderr.write(
+        `\n⚠️  cachly: CACHLY_JWT expired ${Math.abs(minsLeft)} minute(s) ago.\n` +
+        `   All tool calls will fail. Get a fresh token at https://cachly.dev/setup-ai\n\n`,
+      );
+    } else if (minsLeft < 60) {
+      process.stderr.write(
+        `\n⚠️  cachly: CACHLY_JWT expires in ${minsLeft} minute(s).\n` +
+        `   Refresh it soon at https://cachly.dev/setup-ai to avoid interruptions.\n\n`,
+      );
+    }
+  }
 }
 
 // ── Update nudge (non-blocking, fire-and-forget) ─────────────────────────────

package/test-features.cjs

@@ -1,23 +0,0 @@
-const fs = require('fs');
-
-const src = fs.readFileSync('src/index.ts', 'utf8');
-const initSrc = fs.readFileSync('../init/index.js', 'utf8');
-const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-
-let pass = 0, fail = 0;
-function check(name, cond) {
-  if (cond) { console.log('PASS:', name); pass++; }
-  else { console.log('FAIL:', name); fail++; }
-}
-
-check('Test 1 - Ambient git learning in session_end', src.includes('git log --since') || src.includes('Ambient git'));
-check('Test 2a - author param in learn_from_attempts schema', src.includes('"author"') && src.includes('learn_from_attempts'));
-check('Test 2b - Team Telepathy in session_start', src.includes('Team Telepathy') || src.includes('team telepathy'));
-check('Test 3 - memory_crystalize tool', src.includes('memory_crystalize'));
-check('Test 4 - init team detection (~/.cachly-teams.json)', initSrc.includes('cachly-teams.json'));
-check('Test 5 - brain_doctor workspace_path param', src.includes('workspace_path') && src.includes('brain_doctor'));
-check('Bugfix - Pre-Warning uses splice(2,0)', src.includes('splice(2, 0'));
-check('Bugfix - No broken unshift in pre-warning', !src.includes('lines.unshift('));
-check('MCP version is 0.5.26', pkg.version === '0.5.26');
-
-console.log(`\n${pass}/${pass+fail} tests passed`);