@cachly-dev/mcp-server 0.6.1 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.6.1",
+  "version": "0.7.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.6.1';
+const CURRENT_VERSION = '0.7.1';
 /**
  * ┌──────────────────────────────────────────────────────────────────────┐
  * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
@@ -3484,6 +3484,60 @@ const TOOLS = [
       required: ['instance_id'],
     },
   },
+  // ── v0.7 Knowledge Syndication ────────────────────────────────────────────
+  {
+    name: 'syndicate',
+    description:
+      'Contribute a verified lesson to the GLOBAL Cachly Knowledge Commons — ' +
+      'a privacy-preserving shared brain where every AI instance can learn from the discoveries ' +
+      'of every other. Your contributor identity is a one-way HMAC hash: completely anonymous. ' +
+      '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).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        topic:       { type: 'string', description: 'Topic key in category:keyword format (e.g. "fix:clickhouse-ipv6", "deploy:docker-compose")' },
+        outcome:     { type: 'string', enum: ['success', 'failure', 'partial'], description: 'Result of the attempt (default: success)' },
+        what_worked: { type: 'string', description: 'Exact approach, command, or fix that worked. File paths are stripped automatically.' },
+        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' },
+      },
+      required: ['topic', 'what_worked'],
+    },
+  },
+  {
+    name: 'syndicate_search',
+    description:
+      'Search the GLOBAL Cachly Knowledge Commons for solutions contributed by the entire community. ' +
+      'Returns lessons ranked by confirm_count (trust score) then recency. ' +
+      'Use this BEFORE debugging any unknown issue — someone in the global brain likely solved it already. ' +
+      'Example: syndicate_search(q="clickhouse localhost connection refused") → ' +
+      '"fix: use 127.0.0.1 not localhost when IPv6 is disabled · confirmed by 47 instances"',
+    inputSchema: {
+      type: 'object',
+      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"' },
+        limit:    { type: 'number', description: 'Max results to return (default: 20, max: 50)' },
+      },
+      required: [],
+    },
+  },
+  {
+    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. ' +
+      'Use for weekly reviews or to explore what the community knows.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+    },
+  },
 ] as const;
 
 // ── Handlers ──────────────────────────────────────────────────────────────────
@@ -7551,6 +7605,143 @@ smart_recall(
       ].join('\n');
     }
 
+    // ── 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[];
+      };
+
+      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 }>(
+        '/api/v1/syndication/contribute',
+        { method: 'POST', body: JSON.stringify(body) }
+      );
+
+      return [
+        `🌐 **Lesson syndicated to the global Knowledge Commons**`,
+        ``,
+        `**ID:** \`${res.id}\``,
+        `**Topic:** \`${res.topic}\` · **Outcome:** ${res.outcome}`,
+        ``,
+        `Your lesson is now searchable by every AI brain in the network.`,
+        `When another instance confirms it works, its trust score rises automatically.`,
+        ``,
+        `**Tip:** Use \`syndicate_search(q="${topic}")\` to see all community lessons on this topic.`,
+      ].join('\n');
+    }
+
+    // ── v0.7 Knowledge Syndication: syndicate_search ─────────────────────────
+    case 'syndicate_search': {
+      const { q = '', limit = 20, category = '' } = args as { q?: string; limit?: number; category?: string };
+
+      const params = new URLSearchParams();
+      if (q) params.set('q', q);
+      if (category) params.set('category', category);
+      params.set('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; created_at: string;
+      }>; count: number; query: string }>(`/api/v1/syndication/search?${params}`);
+
+      if (!res.results || res.results.length === 0) {
+        return q
+          ? `No lessons found for "${q}" in the global Knowledge Commons yet.\n\nBe the first to contribute: \`syndicate(topic="...", what_worked="...")\``
+          : `The global Knowledge Commons is empty. Be the first contributor:\n\`syndicate(topic="deploy:api", what_worked="...")\``;
+      }
+
+      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 header = [q, category].filter(Boolean).join(' · ');
+      const lines: string[] = [
+        `## 🌐 Global Knowledge Commons${header ? ` — ${header}` : ' — Recent'}`,
+        `*${res.count} lesson${res.count === 1 ? '' : 's'} found*`,
+        ``,
+      ];
+
+      for (const lesson of res.results) {
+        lines.push(
+          `### ${outcomeIcon(lesson.outcome)} \`${lesson.topic}\` ${severityLabel(lesson.severity)}`,
+          `**Trust:** ${confirmBar(lesson.confirm_count)}`,
+          lesson.what_worked ? `**What worked:** ${lesson.what_worked}` : '',
+          lesson.what_failed ? `**What failed:** ${lesson.what_failed}` : '',
+          `*Contributed ${new Date(lesson.created_at).toLocaleDateString('de-DE')} · ID: \`${lesson.id}\`*`,
+          ``,
+        );
+      }
+
+      lines.push(
+        `---`,
+        `**Confirm** (this helped you): \`syndicate(topic="${res.results[0]?.topic ?? '...'}", what_worked="...")\` → auto-deduped, trust +1`,
+        `**Contribute your own:** \`syndicate(topic="fix:...", what_worked="...")\``,
+        `**Filter by category:** \`syndicate_search(category="fix")\``,
+      );
+
+      return lines.filter(l => l !== '').join('\n');
+    }
+
+    // ── v0.7 Knowledge Syndication: syndicate_stats ──────────────────────────
+    case 'syndicate_stats': {
+      const res = await apiFetch<{
+        total_lessons: number;
+        total_confirms: number;
+        added_last_7_days: number;
+        top_categories: Array<{ category: string; count: number }>;
+        most_trusted: Array<{
+          id: string; topic: string; outcome: string;
+          what_worked: string; confirm_count: number; created_at: string;
+        }>;
+      }>('/api/v1/syndication/stats');
+
+      const confirmBar = (n: number) => {
+        const filled = Math.min(10, Math.round(n / 5));
+        return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
+      };
+
+      const lines: string[] = [
+        `## 🌐 Global Knowledge Commons — Stats`,
+        ``,
+        `| Metric | Value |`,
+        `|---|---|`,
+        `| Total lessons | **${res.total_lessons.toLocaleString()}** |`,
+        `| Total confirms | **${res.total_confirms.toLocaleString()}** |`,
+        `| Added last 7 days | **${res.added_last_7_days}** |`,
+        ``,
+        `### Top Categories`,
+      ];
+
+      for (const cat of res.top_categories ?? []) {
+        lines.push(`- \`${cat.category}\` — ${cat.count} lesson${cat.count === 1 ? '' : 's'}`);
+      }
+
+      lines.push(``, `### Most Trusted Lessons`);
+
+      for (const lesson of res.most_trusted ?? []) {
+        lines.push(
+          `**\`${lesson.topic}\`** ${confirmBar(lesson.confirm_count)}`,
+          `> ${lesson.what_worked.slice(0, 120)}${lesson.what_worked.length > 120 ? '…' : ''}`,
+          ``,
+        );
+      }
+
+      lines.push(
+        `---`,
+        `**Contribute:** \`syndicate(topic="...", what_worked="...")\`  |  **Search:** \`syndicate_search(q="your problem")\``,
+      );
+
+      return lines.join('\n');
+    }
+
     default:
       return null;
   }