@cachly-dev/mcp-server 0.7.0 → 0.8.0

package/dist/index.js

@@ -47,7 +47,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.0';
+const CURRENT_VERSION = '0.8.0';
 /**
  * ┌──────────────────────────────────────────────────────────────────────┐
  * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
@@ -3406,7 +3406,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: {
@@ -3416,6 +3417,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'],
         },
@@ -3431,11 +3433,38 @@ const TOOLS = [
             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"' },
+                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: [],
         },
     },
+    {
+        name: 'syndicate_stats',
+        description: 'Show the health of the global Knowledge Commons: total lessons, total confirms, ' +
+            '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',
+            properties: {},
+            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: [],
+        },
+    },
 ];
 // ── Handlers ──────────────────────────────────────────────────────────────────
 function formatInstance(inst) {
@@ -7043,30 +7072,40 @@ smart_recall(
         }
         // ── v0.7 Knowledge Syndication: syndicate ────────────────────────────────
         case 'syndicate': {
-            const { topic, outcome = 'success', what_worked, what_failed = '', severity = 'minor', tags = [] } = args;
+            const { topic, outcome = 'success', what_worked, what_failed = '', severity = 'minor', tags = [], scope = 'public' } = args;
             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 body = { topic, outcome, what_worked, what_failed, severity, tags, scope };
             const res = await apiFetch('/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');
         }
         // ── v0.7 Knowledge Syndication: syndicate_search ─────────────────────────
         case 'syndicate_search': {
-            const { q = '', limit = 20 } = args;
+            const { q = '', limit = 20, category = '', scope = '' } = args;
             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(`/api/v1/syndication/search?${params}`);
             if (!res.results || res.results.length === 0) {
@@ -7080,15 +7119,86 @@ smart_recall(
                 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 = [
-                `## 🌐 Global Knowledge Commons${q ? ` — "${q}"` : ' — Recent'}`,
+                `## 🌐 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')}*`, ``);
+                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('/api/v1/syndication/stats');
+            const confirmBar = (n) => {
+                const filled = Math.min(10, Math.round(n / 5));
+                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
+            };
+            const lines = [
+                `## 🌐 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")\``);
+            // Top contributors (anonymous scores)
+            if (res.top_contributors?.length) {
+                lines.push(``, `### 🏅 Top Contributors (anonymous)`);
+                for (const c of res.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;
+            const params = new URLSearchParams({ limit: String(Math.min(Math.max(1, limit), 50)) });
+            const res = await apiFetch(`/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) => o === 'success' ? '✅' : o === 'failure' ? '❌' : '⚠️';
+            const severityLabel = (s) => s === 'critical' ? '🔴' : s === 'major' ? '🟡' : '🟢';
+            const confirmBar = (n) => {
+                const filled = Math.min(10, Math.round(n / 5));
+                return '█'.repeat(filled) + '░'.repeat(10 - filled) + ` ×${n}`;
+            };
+            const trendBar = (score) => {
+                const filled = Math.min(10, Math.round(score * 2));
+                return '▲'.repeat(filled) + '△'.repeat(10 - filled) + ` ${score.toFixed(2)}/day`;
+            };
+            const lines = [
+                `## 📈 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 a lesson** (it helped you): \`syndicate_search\` → note the ID → \`syndicate_confirm(id="...")\``, `**Contribute your own:** \`syndicate(topic="fix:...", what_worked="...")\``);
+            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: