@cachly-dev/mcp-server 0.7.1 → 0.8.1

package/package.json

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

package/src/index.ts

@@ -55,7 +55,7 @@ import { Redis } from 'ioredis';
 const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
 const JWT = process.env.CACHLY_JWT ?? '';
 const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
-const CURRENT_VERSION = '0.7.1';
+const CURRENT_VERSION = '0.8.1';
 /**
  * ┌──────────────────────────────────────────────────────────────────────┐
  * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
@@ -3494,7 +3494,8 @@ const TOOLS = [
       'The lesson is immediately searchable by any other AI using syndicate_search. ' +
       'This is how individual knowledge becomes collective intelligence. ' +
       'Call this AFTER every learn_from_attempts that is worth sharing universally ' +
-      '(critical bugs, deployment gotchas, architecture discoveries).',
+      '(critical bugs, deployment gotchas, architecture discoveries). ' +
+      'Use scope="org" to keep the lesson private to your organisation.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -3504,6 +3505,7 @@ const TOOLS = [
         what_failed: { type: 'string', description: 'What failed or was wrong — helps others avoid the same trap.' },
         severity:    { type: 'string', enum: ['critical', 'major', 'minor'], description: 'How severe the issue was (default: minor)' },
         tags:        { type: 'array', items: { type: 'string' }, description: 'Up to 10 keywords for better discoverability' },
+        scope:       { type: 'string', enum: ['public', 'org'], description: 'Visibility: "public" = global commons (default), "org" = private to your org only' },
       },
       required: ['topic', 'what_worked'],
     },
@@ -3521,6 +3523,7 @@ const TOOLS = [
       properties: {
         q:        { type: 'string', description: 'Free-text search query (leave empty for most recent lessons)' },
         category: { type: 'string', description: 'Filter by category prefix: "fix", "deploy", "debug", "infra", "api", "web"' },
+        scope:    { type: 'string', enum: ['public', 'org'], description: '"public" = global commons (default), "org" = public + your org-private lessons' },
         limit:    { type: 'number', description: 'Max results to return (default: 20, max: 50)' },
       },
       required: [],
@@ -3530,7 +3533,7 @@ const TOOLS = [
     name: 'syndicate_stats',
     description:
       'Show the health of the global Knowledge Commons: total lessons, total confirms, ' +
-      'top categories, most-trusted lessons, and growth in the last 7 days. ' +
+      'top categories, most-trusted lessons, growth in the last 7 days, and top contributors (anonymous scores). ' +
       'Use for weekly reviews or to explore what the community knows.',
     inputSchema: {
       type: 'object',
@@ -3538,6 +3541,21 @@ const TOOLS = [
       required: [],
     },
   },
+  {
+    name: 'syndicate_trending',
+    description:
+      'Show the TRENDING lessons in the global Knowledge Commons — those with the fastest confirmation velocity ' +
+      'in the last 7 days (confirm_count / age_in_days). ' +
+      'Use this at the start of a session or weekly review to see what the community is actively validating. ' +
+      'Lessons need at least 2 independent confirms to appear here.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        limit: { type: 'number', description: 'Max results (default: 10, max: 50)' },
+      },
+      required: [],
+    },
+  },
 ] as const;
 
 // ── Handlers ──────────────────────────────────────────────────────────────────
@@ -5315,6 +5333,25 @@ async function handleTool(name: string, args: Record<string, unknown>): Promise<
         }
       } catch { /* non-critical */ }
 
+      // ── 🌍 Knowledge Commons — community stats banner ───────────────────────
+      // Fetch syndication stats and show a 1-liner: total lessons + confirms + weekly growth.
+      // Non-fatal: never blocks session start if the API call fails.
+      try {
+        const commonsStats = await apiFetch<{
+          total_lessons: number;
+          total_confirms: number;
+          added_last_7_days: number;
+        }>('/api/v1/syndication/stats');
+        if (commonsStats.total_lessons > 0) {
+          lines.push(
+            `🌍 **Commons:** ${commonsStats.total_lessons.toLocaleString()} lessons · ` +
+            `${commonsStats.total_confirms.toLocaleString()} confirms · ` +
+            `+${commonsStats.added_last_7_days} this week`,
+          );
+          lines.push('');
+        }
+      } catch { /* non-critical — never block session start */ }
+
       return lines.join('\n');
     }
 
@@ -7607,28 +7644,35 @@ smart_recall(
 
     // ── v0.7 Knowledge Syndication: syndicate ────────────────────────────────
     case 'syndicate': {
-      const { topic, outcome = 'success', what_worked, what_failed = '', severity = 'minor', tags = [] } = args as {
-        topic: string; outcome?: string; what_worked: string; what_failed?: string; severity?: string; tags?: string[];
+      const { topic, outcome = 'success', what_worked, what_failed = '', severity = 'minor', tags = [], scope = 'public' } = args as {
+        topic: string; outcome?: string; what_worked: string; what_failed?: string; severity?: string; tags?: string[]; scope?: string;
       };
 
       if (!topic || !what_worked) {
         throw new McpError(ErrorCode.InvalidParams, 'topic and what_worked are required');
       }
 
-      const body = { topic, outcome, what_worked, what_failed, severity, tags };
-      const res = await apiFetch<{ id: string; topic: string; outcome: string; message: string }>(
+      const body = { topic, outcome, what_worked, what_failed, severity, tags, scope };
+      const res = await apiFetch<{ id: string; topic: string; outcome: string; message: string; deduped?: boolean }>(
         '/api/v1/syndication/contribute',
         { method: 'POST', body: JSON.stringify(body) }
       );
 
+      const scopeLabel = scope === 'org' ? '🏢 org-private' : '🌐 global commons';
+      const dedupNote = res.deduped
+        ? `\n> ♻️ Duplicate detected — trust score incremented for the existing lesson.`
+        : '';
+
       return [
-        `🌐 **Lesson syndicated to the global Knowledge Commons**`,
+        `${scope === 'org' ? '🏢' : '🌐'} **Lesson syndicated to the ${scope === 'org' ? 'org Knowledge Commons' : 'global Knowledge Commons'}**${dedupNote}`,
         ``,
         `**ID:** \`${res.id}\``,
-        `**Topic:** \`${res.topic}\` · **Outcome:** ${res.outcome}`,
+        `**Topic:** \`${res.topic}\` · **Outcome:** ${res.outcome} · **Scope:** ${scopeLabel}`,
         ``,
-        `Your lesson is now searchable by every AI brain in the network.`,
-        `When another instance confirms it works, its trust score rises automatically.`,
+        scope === 'org'
+          ? `This lesson is visible only within your organisation. Use \`syndicate_search(scope="org")\` to find it.`
+          : `Your lesson is now searchable by every AI brain in the network.`,
+        `When another instance confirms it works, its trust score rises — and so does your contributor reputation.`,
         ``,
         `**Tip:** Use \`syndicate_search(q="${topic}")\` to see all community lessons on this topic.`,
       ].join('\n');
@@ -7636,11 +7680,12 @@ smart_recall(
 
     // ── v0.7 Knowledge Syndication: syndicate_search ─────────────────────────
     case 'syndicate_search': {
-      const { q = '', limit = 20, category = '' } = args as { q?: string; limit?: number; category?: string };
+      const { q = '', limit = 20, category = '', scope = '' } = args as { q?: string; limit?: number; category?: string; scope?: string };
 
       const params = new URLSearchParams();
       if (q) params.set('q', q);
       if (category) params.set('category', category);
+      if (scope) params.set('scope', scope);
       params.set('limit', String(Math.min(Math.max(1, limit), 50)));
 
       const res = await apiFetch<{ results: Array<{
@@ -7739,9 +7784,74 @@ smart_recall(
         `**Contribute:** \`syndicate(topic="...", what_worked="...")\`  |  **Search:** \`syndicate_search(q="your problem")\``,
       );
 
+      // Top contributors (anonymous scores)
+      if ((res as any).top_contributors?.length) {
+        lines.push(``, `### 🏅 Top Contributors (anonymous)`);
+        for (const c of (res as any).top_contributors) {
+          lines.push(`- Trust **${c.trust_score}** · ${c.lessons_count} lesson${c.lessons_count === 1 ? '' : 's'} · ${c.confirms_received} confirms received`);
+        }
+      }
+
       return lines.join('\n');
     }
 
+    // ── v0.8 Knowledge Syndication: syndicate_trending ───────────────────────
+    case 'syndicate_trending': {
+      const { limit = 10 } = args as { limit?: number };
+
+      const params = new URLSearchParams({ limit: String(Math.min(Math.max(1, limit), 50)) });
+      const res = await apiFetch<{ results: Array<{
+        id: string; topic: string; category: string; outcome: string;
+        what_worked: string; what_failed: string; severity: string;
+        confirm_count: number; trend_score: number; created_at: string;
+      }>; count: number }>(`/api/v1/syndication/trending?${params}`);
+
+      if (!res.results || res.results.length === 0) {
+        return [
+          `## 📈 Trending in the Knowledge Commons`,
+          ``,
+          `No trending lessons yet (need at least 2 confirms in the last 7 days).`,
+          ``,
+          `Contribute and confirm lessons to see them trend: \`syndicate(topic="...", what_worked="...")\``,
+        ].join('\n');
+      }
+
+      const outcomeIcon = (o: string) => o === 'success' ? '✅' : o === 'failure' ? '❌' : '⚠️';
+      const severityLabel = (s: string) => s === 'critical' ? '🔴' : s === 'major' ? '🟡' : '🟢';
+      const confirmBar = (n: number) => {
+        const filled = Math.min(10, Math.round(n / 5));
+        return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
+      };
+      const trendBar = (score: number) => {
+        const filled = Math.min(10, Math.round(score * 2));
+        return '▲'.repeat(filled) + '△'.repeat(10 - filled) + ` ${score.toFixed(2)}/day`;
+      };
+
+      const lines: string[] = [
+        `## 📈 Trending in the Knowledge Commons`,
+        `*Lessons with the fastest confirmation velocity in the last 7 days*`,
+        ``,
+      ];
+
+      for (const lesson of res.results) {
+        lines.push(
+          `### ${outcomeIcon(lesson.outcome)} \`${lesson.topic}\` ${severityLabel(lesson.severity)}`,
+          `**Trend:** ${trendBar(lesson.trend_score)}  |  **Trust:** ${confirmBar(lesson.confirm_count)}`,
+          lesson.what_worked ? `**What worked:** ${lesson.what_worked.slice(0, 200)}${lesson.what_worked.length > 200 ? '…' : ''}` : '',
+          `*ID: \`${lesson.id}\` · ${new Date(lesson.created_at).toLocaleDateString('de-DE')}*`,
+          ``,
+        );
+      }
+
+      lines.push(
+        `---`,
+        `**Confirm** (if this helped you): \`syndicate(topic="${res.results[0]?.topic ?? '...'}", what_worked="...")\` → auto-deduped, trust +1`,
+        `**All trending:** \`syndicate_trending(limit=50)\`  |  **Search:** \`syndicate_search(q="...")\``,
+      );
+
+      return lines.filter(l => l !== '').join('\n');
+    }
+
     default:
       return null;
   }