@rigour-labs/mcp 6.5.2 → 6.5.3

package/README.md

@@ -48,8 +48,8 @@ Rigour moves code quality enforcement from "Post-Commit" to "In-Progress." By ru
 
 | Tool | Description |
 |:---|:---|
-| `rigour_remember` | DLP-gated persistent memory — scans values before storing. |
-| `rigour_recall` | DLP-gated recall — blocks tainted memories on read. |
+| `rigour_remember` | Memory for this repository, all your repositories (`scope: "user"`), or your team (`scope: "team"`, served once promoted). Refuses values containing credentials. |
+| `rigour_recall` | `query`: the memories that match by meaning, plus promoted team knowledge; `key`: one memory. Withholds any memory containing a credential. |
 | `rigour_forget` | Removes a stored memory by key. |
 
 ### Real-Time Hooks & DLP
@@ -111,21 +111,17 @@ Hallucinated import detection with full stdlib whitelists and dependency manifes
 
 ## 📦 Installation
 
-### 1. Install via npm
-```bash
-npm install -g @rigour-labs/mcp
-```
+No global install: npx fetches the server when your agent starts it. Keep a version in the package name (`@latest`, or a major such as `@6`); with a bare `@rigour-labs/mcp`, npx runs any older copy installed globally instead. If you once ran `npm install -g @rigour-labs/mcp`, remove it with `npm rm -g @rigour-labs/mcp`.
 
-### 2. Configure your IDE
+**Claude Code:** use the plugin (`/plugin marketplace add rigour-labs/rigour-plugin`, then `/plugin install rigour@rigour-labs`).
 
-#### Cursor / Claude Desktop
-Add the following to your MCP settings:
+**Cursor, Claude Desktop and other MCP clients:**
 ```json
 {
   "mcpServers": {
     "rigour": {
       "command": "npx",
-      "args": ["-y", "@rigour-labs/mcp@5.3.2"],
+      "args": ["-y", "@rigour-labs/mcp@latest"],
       "env": {
         "RIGOUR_CWD": "/path/to/your/project"
       }
@@ -134,6 +130,8 @@ Add the following to your MCP settings:
 }
 ```
 
+Only Rigour's core tools are listed by default; add `"RIGOUR_MCP_TOOLS": "governance,telemetry"` (or `"full"`) to `env` for the rest. Node.js 22 or later is required.
+
 ---
 
 ## 📖 Documentation

package/dist/advertised-tools.d.ts

@@ -154,6 +154,11 @@ export declare function getAdvertisedToolDefinitions(spec?: string): ({
                 type: string;
                 description: string;
             };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             cwd: {
                 type: "string";
                 description: string;
@@ -178,6 +183,39 @@ export declare function getAdvertisedToolDefinitions(spec?: string): ({
                 type: string;
                 description: string;
             };
+            query: {
+                type: string;
+                description: string;
+            };
+            cwd: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            key: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             cwd: {
                 type: "string";
                 description: string;
@@ -210,6 +248,17 @@ export declare function getAdvertisedToolDefinitions(spec?: string): ({
                 type: string;
                 description: string;
             };
+            signature: {
+                type: string;
+                description: string;
+            };
+            keywords: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             file: {
                 type: string;
                 description: string;

package/dist/dashboard/html.d.ts

@@ -12,4 +12,4 @@
  *
  * No external dependencies. Initial state injected via __INITIAL_STATE__.
  */
-export declare const DASHBOARD_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<title>Rigour Governance</title>\n<style>\n*{margin:0;padding:0;box-sizing:border-box}\nbody{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#c9d1d9;padding:16px;font-size:13px;line-height:1.5}\n.header{display:flex;align-items:center;gap:8px;margin-bottom:16px}\n.header h1{font-size:15px;font-weight:600;color:#f0f6fc}\n.header .badge{font-size:11px;padding:2px 8px;border-radius:12px;font-weight:500}\n.badge-pass{background:#1a7f37;color:#fff}\n.badge-fail{background:#da3633;color:#fff}\n.badge-scanning{background:#9e6a03;color:#fff}\n.badge-idle{background:#30363d;color:#8b949e}\n.top{display:flex;gap:16px;margin-bottom:16px}\n.gauge-wrap{flex:0 0 100px;text-align:center}\n.gauge-label{font-size:11px;color:#8b949e;margin-top:4px}\n.severity-wrap{flex:1;display:flex;flex-direction:column;justify-content:center;gap:6px}\n.sev-row{display:flex;align-items:center;gap:6px;font-size:12px}\n.sev-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0}\n.sev-critical{background:#da3633}\n.sev-high{background:#db6d28}\n.sev-medium{background:#9e6a03}\n.sev-low{background:#388bfd}\n.sev-info{background:#8b949e}\n.sev-count{color:#f0f6fc;font-weight:600;min-width:18px}\n.section-title{font-size:11px;color:#8b949e;text-transform:uppercase;letter-spacing:.5px;margin-bottom:8px;font-weight:600}\n.timeline{max-height:200px;overflow-y:auto;margin-bottom:16px}\n.timeline::-webkit-scrollbar{width:4px}\n.timeline::-webkit-scrollbar-thumb{background:#30363d;border-radius:2px}\n.tl-entry{display:flex;gap:8px;padding:4px 0;border-bottom:1px solid #21262d;font-size:12px}\n.tl-time{color:#8b949e;flex:0 0 55px;font-family:'SF Mono',Monaco,monospace;font-size:11px}\n.tl-tool{color:#58a6ff;flex:0 0 auto}\n.tl-arrow{color:#484f58}\n.tl-detail{color:#c9d1d9;flex:1}\n.tl-status-success .tl-detail{color:#3fb950}\n.tl-status-error .tl-detail{color:#da3633}\n.tl-status-warning .tl-detail{color:#d29922}\n.brain{display:flex;align-items:center;gap:8px;padding:8px 12px;background:#161b22;border:1px solid #30363d;border-radius:6px;font-size:12px}\n.brain-icon{font-size:16px}\n.brain-text{color:#c9d1d9}\n.brain-trend{color:#3fb950;font-weight:600}\n.brain-trend.down{color:#da3633}\n.empty{text-align:center;padding:32px 16px;color:#484f58;font-size:12px}\n</style>\n</head>\n<body>\n<div class=\"header\">\n  <h1>Rigour Governance</h1>\n  <span class=\"badge badge-idle\" id=\"statusBadge\">idle</span>\n</div>\n\n<div class=\"top\">\n  <div class=\"gauge-wrap\">\n    <svg viewBox=\"0 0 100 100\" width=\"90\" height=\"90\">\n      <circle cx=\"50\" cy=\"50\" r=\"42\" fill=\"none\" stroke=\"#21262d\" stroke-width=\"8\"/>\n      <circle cx=\"50\" cy=\"50\" r=\"42\" fill=\"none\" stroke=\"#30363d\" stroke-width=\"8\"\n        stroke-dasharray=\"264\" stroke-dashoffset=\"264\" stroke-linecap=\"round\"\n        transform=\"rotate(-90 50 50)\" id=\"gaugeArc\"/>\n      <text x=\"50\" y=\"46\" text-anchor=\"middle\" fill=\"#f0f6fc\" font-size=\"22\" font-weight=\"700\" id=\"gaugeText\">--</text>\n      <text x=\"50\" y=\"62\" text-anchor=\"middle\" fill=\"#8b949e\" font-size=\"9\">SCORE</text>\n    </svg>\n  </div>\n  <div class=\"severity-wrap\" id=\"severityWrap\">\n    <div class=\"sev-row\"><span class=\"sev-dot sev-critical\"></span><span class=\"sev-count\" id=\"sevCritical\">0</span>critical</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-high\"></span><span class=\"sev-count\" id=\"sevHigh\">0</span>high</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-medium\"></span><span class=\"sev-count\" id=\"sevMedium\">0</span>medium</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-low\"></span><span class=\"sev-count\" id=\"sevLow\">0</span>low</div>\n  </div>\n</div>\n\n<div class=\"section-title\">Activity</div>\n<div class=\"timeline\" id=\"timeline\">\n  <div class=\"empty\">Waiting for agent activity...</div>\n</div>\n\n<div class=\"brain\" id=\"brainSection\">\n  <span class=\"brain-icon\">&#x1F9E0;</span>\n  <span class=\"brain-text\" id=\"brainText\">Brain: waiting for data</span>\n  <span class=\"brain-trend\" id=\"brainTrend\"></span>\n</div>\n\n<script>\nconst state = JSON.parse('__INITIAL_STATE__');\n\nfunction scoreColor(s) {\n  if (s === null) return '#30363d';\n  if (s < 50) return '#da3633';\n  if (s < 80) return '#d29922';\n  return '#3fb950';\n}\n\nfunction updateGauge(score) {\n  const arc = document.getElementById('gaugeArc');\n  const text = document.getElementById('gaugeText');\n  if (score === null) {\n    arc.setAttribute('stroke-dashoffset', '264');\n    arc.setAttribute('stroke', '#30363d');\n    text.textContent = '--';\n    return;\n  }\n  const offset = 264 - (264 * Math.min(score, 100) / 100);\n  arc.setAttribute('stroke-dashoffset', String(offset));\n  arc.setAttribute('stroke', scoreColor(score));\n  text.textContent = String(Math.round(score));\n}\n\nfunction updateBadge(status) {\n  const badge = document.getElementById('statusBadge');\n  badge.className = 'badge badge-' + (status || 'idle');\n  const labels = {pass:'PASS',fail:'FAIL',scanning:'SCANNING'};\n  badge.textContent = labels[status] || 'IDLE';\n}\n\nfunction updateSeverity(sev) {\n  document.getElementById('sevCritical').textContent = sev.critical || 0;\n  document.getElementById('sevHigh').textContent = sev.high || 0;\n  document.getElementById('sevMedium').textContent = sev.medium || 0;\n  document.getElementById('sevLow').textContent = sev.low || 0;\n}\n\nfunction formatTime(iso) {\n  const d = new Date(iso);\n  return d.toLocaleTimeString('en-US', {hour12:false,hour:'2-digit',minute:'2-digit',second:'2-digit'});\n}\n\nfunction renderTimeline(entries) {\n  const el = document.getElementById('timeline');\n  if (!entries.length) {\n    el.innerHTML = '<div class=\"empty\">Waiting for agent activity...</div>';\n    return;\n  }\n  el.innerHTML = entries.map(e => {\n    const cls = e.status === 'success' ? 'tl-status-success' : e.status === 'error' ? 'tl-status-error' : 'tl-status-warning';\n    return '<div class=\"tl-entry ' + cls + '\">' +\n      '<span class=\"tl-time\">' + formatTime(e.timestamp) + '</span>' +\n      '<span class=\"tl-tool\">' + e.tool + '</span>' +\n      '<span class=\"tl-arrow\">\u2192</span>' +\n      '<span class=\"tl-detail\">' + e.details + '</span></div>';\n  }).join('');\n  el.scrollTop = el.scrollHeight;\n}\n\nfunction updateBrain(patterns, trend) {\n  const text = document.getElementById('brainText');\n  const trendEl = document.getElementById('brainTrend');\n  text.textContent = 'Brain: ' + patterns + ' patterns learned';\n  if (trend) {\n    const arrows = {improving:'\u2191',stable:'\u2194',declining:'\u2193'};\n    trendEl.textContent = (arrows[trend] || '') + ' ' + trend;\n    trendEl.className = 'brain-trend' + (trend === 'declining' ? ' down' : '');\n  }\n}\n\nfunction render() {\n  updateGauge(state.currentScore);\n  updateBadge(state.status);\n  updateSeverity(state.severityBreakdown || {});\n  renderTimeline(state.timeline || []);\n  updateBrain(state.brainPatterns || 0, state.brainTrend);\n}\n\nrender();\n</script>\n</body>\n</html>";
+export declare const DASHBOARD_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"UTF-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<title>Rigour Governance</title>\n<style>\n*{margin:0;padding:0;box-sizing:border-box}\nbody{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#c9d1d9;padding:16px;font-size:13px;line-height:1.5}\n.header{display:flex;align-items:center;gap:8px;margin-bottom:16px}\n.header h1{font-size:15px;font-weight:600;color:#f0f6fc}\n.header .badge{font-size:11px;padding:2px 8px;border-radius:12px;font-weight:500}\n.badge-pass{background:#1a7f37;color:#fff}\n.badge-fail{background:#da3633;color:#fff}\n.badge-scanning{background:#9e6a03;color:#fff}\n.badge-idle{background:#30363d;color:#8b949e}\n.top{display:flex;gap:16px;margin-bottom:16px}\n.gauge-wrap{flex:0 0 100px;text-align:center}\n.gauge-label{font-size:11px;color:#8b949e;margin-top:4px}\n.severity-wrap{flex:1;display:flex;flex-direction:column;justify-content:center;gap:6px}\n.sev-row{display:flex;align-items:center;gap:6px;font-size:12px}\n.sev-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0}\n.sev-critical{background:#da3633}\n.sev-high{background:#db6d28}\n.sev-medium{background:#9e6a03}\n.sev-low{background:#388bfd}\n.sev-info{background:#8b949e}\n.sev-count{color:#f0f6fc;font-weight:600;min-width:18px}\n.section-title{font-size:11px;color:#8b949e;text-transform:uppercase;letter-spacing:.5px;margin-bottom:8px;font-weight:600}\n.timeline{max-height:200px;overflow-y:auto;margin-bottom:16px}\n.timeline::-webkit-scrollbar{width:4px}\n.timeline::-webkit-scrollbar-thumb{background:#30363d;border-radius:2px}\n.tl-entry{display:flex;gap:8px;padding:4px 0;border-bottom:1px solid #21262d;font-size:12px}\n.tl-time{color:#8b949e;flex:0 0 55px;font-family:'SF Mono',Monaco,monospace;font-size:11px}\n.tl-tool{color:#58a6ff;flex:0 0 auto}\n.tl-arrow{color:#484f58}\n.tl-detail{color:#c9d1d9;flex:1}\n.tl-status-success .tl-detail{color:#3fb950}\n.tl-status-error .tl-detail{color:#da3633}\n.tl-status-warning .tl-detail{color:#d29922}\n.brain{display:flex;align-items:center;gap:8px;padding:8px 12px;background:#161b22;border:1px solid #30363d;border-radius:6px;font-size:12px}\n.brain-icon{font-size:16px}\n.brain-text{color:#c9d1d9}\n.brain-trend{color:#3fb950;font-weight:600}\n.brain-trend.down{color:#da3633}\n.empty{text-align:center;padding:32px 16px;color:#484f58;font-size:12px}\n</style>\n</head>\n<body>\n<div class=\"header\">\n  <h1>Rigour Governance</h1>\n  <span class=\"badge badge-idle\" id=\"statusBadge\">idle</span>\n</div>\n\n<div class=\"top\">\n  <div class=\"gauge-wrap\">\n    <svg viewBox=\"0 0 100 100\" width=\"90\" height=\"90\">\n      <circle cx=\"50\" cy=\"50\" r=\"42\" fill=\"none\" stroke=\"#21262d\" stroke-width=\"8\"/>\n      <circle cx=\"50\" cy=\"50\" r=\"42\" fill=\"none\" stroke=\"#30363d\" stroke-width=\"8\"\n        stroke-dasharray=\"264\" stroke-dashoffset=\"264\" stroke-linecap=\"round\"\n        transform=\"rotate(-90 50 50)\" id=\"gaugeArc\"/>\n      <text x=\"50\" y=\"46\" text-anchor=\"middle\" fill=\"#f0f6fc\" font-size=\"22\" font-weight=\"700\" id=\"gaugeText\">--</text>\n      <text x=\"50\" y=\"62\" text-anchor=\"middle\" fill=\"#8b949e\" font-size=\"9\">SCORE</text>\n    </svg>\n  </div>\n  <div class=\"severity-wrap\" id=\"severityWrap\">\n    <div class=\"sev-row\"><span class=\"sev-dot sev-critical\"></span><span class=\"sev-count\" id=\"sevCritical\">0</span>critical</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-high\"></span><span class=\"sev-count\" id=\"sevHigh\">0</span>high</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-medium\"></span><span class=\"sev-count\" id=\"sevMedium\">0</span>medium</div>\n    <div class=\"sev-row\"><span class=\"sev-dot sev-low\"></span><span class=\"sev-count\" id=\"sevLow\">0</span>low</div>\n  </div>\n</div>\n\n<div class=\"section-title\">Activity</div>\n<div class=\"timeline\" id=\"timeline\">\n  <div class=\"empty\">Waiting for agent activity...</div>\n</div>\n\n<div class=\"brain\" id=\"brainSection\">\n  <span class=\"brain-icon\">&#x1F9E0;</span>\n  <span class=\"brain-text\" id=\"brainText\">Knowledge: waiting for the first tool call</span>\n  <span class=\"brain-trend\" id=\"brainTrend\"></span>\n</div>\n\n<script>\nconst state = JSON.parse('__INITIAL_STATE__');\n\nfunction scoreColor(s) {\n  if (s === null) return '#30363d';\n  if (s < 50) return '#da3633';\n  if (s < 80) return '#d29922';\n  return '#3fb950';\n}\n\nfunction updateGauge(score) {\n  const arc = document.getElementById('gaugeArc');\n  const text = document.getElementById('gaugeText');\n  if (score === null) {\n    arc.setAttribute('stroke-dashoffset', '264');\n    arc.setAttribute('stroke', '#30363d');\n    text.textContent = '--';\n    return;\n  }\n  const offset = 264 - (264 * Math.min(score, 100) / 100);\n  arc.setAttribute('stroke-dashoffset', String(offset));\n  arc.setAttribute('stroke', scoreColor(score));\n  text.textContent = String(Math.round(score));\n}\n\nfunction updateBadge(status, source) {\n  const badge = document.getElementById('statusBadge');\n  badge.className = 'badge badge-' + (status || 'idle');\n  const labels = {pass:'PASS',fail:'FAIL',scanning:'SCANNING'};\n  badge.textContent = (labels[status] || 'IDLE') + (source === 'last-report' && status !== 'scanning' ? ' \u00B7 LAST CHECK' : '');\n}\n\nfunction updateSeverity(sev) {\n  document.getElementById('sevCritical').textContent = sev.critical || 0;\n  document.getElementById('sevHigh').textContent = sev.high || 0;\n  document.getElementById('sevMedium').textContent = sev.medium || 0;\n  document.getElementById('sevLow').textContent = sev.low || 0;\n}\n\nfunction formatTime(iso) {\n  const d = new Date(iso);\n  return d.toLocaleTimeString('en-US', {hour12:false,hour:'2-digit',minute:'2-digit',second:'2-digit'});\n}\n\nfunction renderTimeline(entries) {\n  const el = document.getElementById('timeline');\n  if (!entries.length) {\n    el.innerHTML = '<div class=\"empty\">Waiting for agent activity...</div>';\n    return;\n  }\n  el.innerHTML = entries.map(e => {\n    const cls = e.status === 'success' ? 'tl-status-success' : e.status === 'error' ? 'tl-status-error' : 'tl-status-warning';\n    return '<div class=\"tl-entry ' + cls + '\">' +\n      '<span class=\"tl-time\">' + formatTime(e.timestamp) + '</span>' +\n      '<span class=\"tl-tool\">' + e.tool + '</span>' +\n      '<span class=\"tl-arrow\">\u2192</span>' +\n      '<span class=\"tl-detail\">' + e.details + '</span></div>';\n  }).join('');\n  el.scrollTop = el.scrollHeight;\n}\n\nfunction updateBrain(k) {\n  const text = document.getElementById('brainText');\n  const detail = document.getElementById('brainTrend');\n  if (!k) { text.textContent = 'Knowledge: waiting for the first tool call'; detail.textContent = ''; return; }\n  const parts = [];\n  if (k.memories) parts.push(k.memories + (k.memories === 1 ? ' memory' : ' memories'));\n  if (k.lessons) parts.push(k.lessons + (k.lessons === 1 ? ' lesson' : ' lessons') + ' (' + k.trustedLessons + ' trusted)');\n  if (k.learnedRules) parts.push(k.learnedRules + ' learned ' + (k.learnedRules === 1 ? 'rule' : 'rules'));\n  if (k.indexedPatterns) parts.push(k.indexedPatterns + ' patterns indexed');\n  text.textContent = parts.length ? 'Knows: ' + parts.join(' \u00B7 ') : 'Nothing learned yet';\n  detail.textContent = k.mutedChecks ? k.mutedChecks + ' noisy check(s) muted' : parts.length ? '' : 'learns from fixes, dismissals and rigour_remember';\n  detail.className = 'brain-trend';\n}\n\nfunction render() {\n  updateGauge(state.currentScore);\n  updateBadge(state.status, state.scoreSource);\n  updateSeverity(state.severityBreakdown || {});\n  renderTimeline(state.timeline || []);\n  updateBrain(state.knowledge);\n}\n\nrender();\n</script>\n</body>\n</html>";

package/dist/dashboard/html.js

@@ -92,7 +92,7 @@ body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;b
 
 <div class="brain" id="brainSection">
   <span class="brain-icon">&#x1F9E0;</span>
-  <span class="brain-text" id="brainText">Brain: waiting for data</span>
+  <span class="brain-text" id="brainText">Knowledge: waiting for the first tool call</span>
   <span class="brain-trend" id="brainTrend"></span>
 </div>
 
@@ -121,11 +121,11 @@ function updateGauge(score) {
   text.textContent = String(Math.round(score));
 }
 
-function updateBadge(status) {
+function updateBadge(status, source) {
   const badge = document.getElementById('statusBadge');
   badge.className = 'badge badge-' + (status || 'idle');
   const labels = {pass:'PASS',fail:'FAIL',scanning:'SCANNING'};
-  badge.textContent = labels[status] || 'IDLE';
+  badge.textContent = (labels[status] || 'IDLE') + (source === 'last-report' && status !== 'scanning' ? ' \u00b7 LAST CHECK' : '');
 }
 
 function updateSeverity(sev) {
@@ -157,23 +157,26 @@ function renderTimeline(entries) {
   el.scrollTop = el.scrollHeight;
 }
 
-function updateBrain(patterns, trend) {
+function updateBrain(k) {
   const text = document.getElementById('brainText');
-  const trendEl = document.getElementById('brainTrend');
-  text.textContent = 'Brain: ' + patterns + ' patterns learned';
-  if (trend) {
-    const arrows = {improving:'\u2191',stable:'\u2194',declining:'\u2193'};
-    trendEl.textContent = (arrows[trend] || '') + ' ' + trend;
-    trendEl.className = 'brain-trend' + (trend === 'declining' ? ' down' : '');
-  }
+  const detail = document.getElementById('brainTrend');
+  if (!k) { text.textContent = 'Knowledge: waiting for the first tool call'; detail.textContent = ''; return; }
+  const parts = [];
+  if (k.memories) parts.push(k.memories + (k.memories === 1 ? ' memory' : ' memories'));
+  if (k.lessons) parts.push(k.lessons + (k.lessons === 1 ? ' lesson' : ' lessons') + ' (' + k.trustedLessons + ' trusted)');
+  if (k.learnedRules) parts.push(k.learnedRules + ' learned ' + (k.learnedRules === 1 ? 'rule' : 'rules'));
+  if (k.indexedPatterns) parts.push(k.indexedPatterns + ' patterns indexed');
+  text.textContent = parts.length ? 'Knows: ' + parts.join(' \u00b7 ') : 'Nothing learned yet';
+  detail.textContent = k.mutedChecks ? k.mutedChecks + ' noisy check(s) muted' : parts.length ? '' : 'learns from fixes, dismissals and rigour_remember';
+  detail.className = 'brain-trend';
 }
 
 function render() {
   updateGauge(state.currentScore);
-  updateBadge(state.status);
+  updateBadge(state.status, state.scoreSource);
   updateSeverity(state.severityBreakdown || {});
   renderTimeline(state.timeline || []);
-  updateBrain(state.brainPatterns || 0, state.brainTrend);
+  updateBrain(state.knowledge);
 }
 
 render();

package/dist/dashboard/index.d.ts

@@ -1,4 +1,5 @@
 export declare const DASHBOARD_URI = "ui://rigour/dashboard";
 /** Get dashboard HTML with current state injected. */
 export declare function getDashboardHtml(): string;
-export { getState, pushTimelineEntry, updateScore, updateBrainStatus, setScanning } from './state.js';
+export { getState, pushTimelineEntry, updateScore, updateKnowledge, seedFromLastReport, setScanning } from './state.js';
+export { summarizeKnowledge, LEARNING_TOOLS, type KnowledgeSummary } from './knowledge.js';

package/dist/dashboard/index.js

@@ -13,4 +13,5 @@ export function getDashboardHtml() {
     const stateJson = JSON.stringify(getState()).replace(/'/g, "\\'");
     return DASHBOARD_HTML.replace('__INITIAL_STATE__', stateJson);
 }
-export { getState, pushTimelineEntry, updateScore, updateBrainStatus, setScanning } from './state.js';
+export { getState, pushTimelineEntry, updateScore, updateKnowledge, seedFromLastReport, setScanning } from './state.js';
+export { summarizeKnowledge, LEARNING_TOOLS } from './knowledge.js';

package/dist/dashboard/knowledge.d.ts

@@ -0,0 +1,15 @@
+export interface KnowledgeSummary {
+    memories: number;
+    lessons: number;
+    /** Lessons agents may act on: validated by repeated fixes, or promoted by a person. */
+    trustedLessons: number;
+    learnedRules: number;
+    indexedPatterns: number;
+    mutedChecks: number;
+}
+/** Tools that change what Rigour knows: after them the summary is recomputed, never served from cache. */
+export declare const LEARNING_TOOLS: Set<string>;
+export declare function summarizeKnowledge(cwd: string, options?: {
+    fresh?: boolean;
+    now?: number;
+}): Promise<KnowledgeSummary>;

package/dist/dashboard/knowledge.js

@@ -0,0 +1,47 @@
+/**
+ * What Rigour knows about this repository, for the dashboard's knowledge line:
+ * read from the stores the learning features write, after every tool call.
+ * Each count is cheap (small JSON files, one local lesson query, the index
+ * stats) and any store that cannot be read counts as zero.
+ */
+import { checkPrecisions, listKnowledgeLessons, loadLearnedRules } from '@rigour-labs/core';
+import { getDefaultIndexPath, loadPatternIndex } from '@rigour-labs/core/pattern-index';
+import { loadMemory } from '../utils/config.js';
+/** Summaries per repository for a short while: tool calls come in bursts and the counts change slowly. */
+const SUMMARY_TTL_MS = 30_000;
+const summaries = new Map();
+/** Tools that change what Rigour knows: after them the summary is recomputed, never served from cache. */
+export const LEARNING_TOOLS = new Set(['rigour_remember', 'rigour_forget', 'rigour_index', 'rigour_review', 'rigour_review_ack']);
+export async function summarizeKnowledge(cwd, options = {}) {
+    const now = options.now ?? Date.now();
+    const cached = summaries.get(cwd);
+    if (!options.fresh && cached && now - cached.at < SUMMARY_TTL_MS)
+        return cached.summary;
+    const summary = await computeSummary(cwd);
+    summaries.set(cwd, { at: now, summary });
+    return summary;
+}
+async function computeSummary(cwd) {
+    const [repo, user, lessons, index] = await Promise.all([
+        loadMemory(cwd, 'repo').catch(() => ({ memories: {} })),
+        loadMemory(cwd, 'user').catch(() => ({ memories: {} })),
+        listKnowledgeLessons(cwd).catch(() => []),
+        loadPatternIndex(getDefaultIndexPath(cwd)).catch(() => null),
+    ]);
+    return {
+        memories: new Set([...Object.keys(repo.memories), ...Object.keys(user.memories)]).size,
+        lessons: lessons.length,
+        trustedLessons: lessons.filter(l => l.state === 'validated' || l.state === 'promoted').length,
+        learnedRules: safeCount(() => loadLearnedRules(cwd).length),
+        indexedPatterns: index?.stats.totalPatterns ?? 0,
+        mutedChecks: safeCount(() => checkPrecisions(cwd).filter(c => c.muted).length),
+    };
+}
+function safeCount(count) {
+    try {
+        return count();
+    }
+    catch {
+        return 0;
+    }
+}

package/dist/dashboard/state.d.ts

@@ -5,6 +5,7 @@
  * the MCP App dashboard HTML on each resource fetch.
  * Single-threaded Node.js — no locking needed.
  */
+import type { KnowledgeSummary } from './knowledge.js';
 export interface TimelineEntry {
     timestamp: string;
     tool: string;
@@ -14,13 +15,26 @@ export interface TimelineEntry {
 export interface DashboardState {
     currentScore: number | null;
     status: "pass" | "fail" | "scanning" | null;
+    /** Where the score came from: a check in this session, or the last report on disk. */
+    scoreSource: "session" | "last-report" | null;
     timeline: TimelineEntry[];
     severityBreakdown: Record<string, number>;
-    brainPatterns: number;
-    brainTrend: string | null;
+    /** What Rigour knows about this repository (knowledge.ts); null until the first tool call. */
+    knowledge: KnowledgeSummary | null;
 }
 export declare function getState(): DashboardState;
 export declare function pushTimelineEntry(tool: string, status: string, details: string): void;
 export declare function updateScore(score: number, status: "pass" | "fail", severity?: Record<string, number>): void;
-export declare function updateBrainStatus(patterns: number, trend?: string): void;
+/**
+ * Start from the last check run anywhere (CLI, hook, CI) while this session has not run one:
+ * otherwise the dashboard shows "--" next to a fix packet that came from that very report.
+ */
+export declare function seedFromLastReport(report: {
+    status?: string;
+    stats?: {
+        score?: number;
+        severity_breakdown?: Record<string, number>;
+    };
+} | null): void;
+export declare function updateKnowledge(knowledge: KnowledgeSummary | null): void;
 export declare function setScanning(): void;

package/dist/dashboard/state.js

@@ -9,10 +9,10 @@ const MAX_TIMELINE = 50;
 const state = {
     currentScore: null,
     status: null,
+    scoreSource: null,
     timeline: [],
     severityBreakdown: {},
-    brainPatterns: 0,
-    brainTrend: null,
+    knowledge: null,
 };
 export function getState() {
     return state;
@@ -31,13 +31,26 @@ export function pushTimelineEntry(tool, status, details) {
 export function updateScore(score, status, severity) {
     state.currentScore = score;
     state.status = status;
+    state.scoreSource = "session";
     if (severity)
         state.severityBreakdown = severity;
 }
-export function updateBrainStatus(patterns, trend) {
-    state.brainPatterns = patterns;
-    if (trend)
-        state.brainTrend = trend;
+/**
+ * Start from the last check run anywhere (CLI, hook, CI) while this session has not run one:
+ * otherwise the dashboard shows "--" next to a fix packet that came from that very report.
+ */
+export function seedFromLastReport(report) {
+    if (state.scoreSource === "session" || typeof report?.stats?.score !== "number")
+        return;
+    state.currentScore = report.stats.score;
+    state.status = report.status === "PASS" ? "pass" : "fail";
+    state.scoreSource = "last-report";
+    if (report.stats.severity_breakdown)
+        state.severityBreakdown = report.stats.severity_breakdown;
+}
+export function updateKnowledge(knowledge) {
+    if (knowledge)
+        state.knowledge = knowledge;
 }
 export function setScanning() {
     state.status = "scanning";

package/dist/index.js

@@ -7,6 +7,8 @@
  *
  * @since v2.17.0 — refactored from 1,487-line monolith
  */
+import fs from 'fs-extra';
+import path from 'path';
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
@@ -18,12 +20,13 @@ import { bindServer } from './utils/notifications.js';
 import { getMcpVersion } from './utils/package-version.js';
 import { buildMcpResultMeta, buildStudioImpact } from './utils/impact-receipt.js';
 // Dashboard (MCP App)
-import { DASHBOARD_URI, getDashboardHtml, pushTimelineEntry, updateScore } from './dashboard/index.js';
+import { DASHBOARD_URI, getDashboardHtml, LEARNING_TOOLS, pushTimelineEntry, seedFromLastReport, summarizeKnowledge, updateKnowledge, updateScore } from './dashboard/index.js';
 // Tool definitions & advertised registry
 import { getAdvertisedToolDefinitions } from './advertised-tools.js';
 // Tool handlers
 import { handleCheck, handleExplain, handleStatus, handleGetFixPacket, handleListGates, handleGetConfig } from './tools/quality-handlers.js';
-import { handleRemember, handleRecall, handleForget } from './tools/memory-handlers.js';
+import { handleRemember, handleForget } from './tools/memory-handlers.js';
+import { handleRecall } from './tools/memory-recall.js';
 import { handleCheckPattern, handleSecurityAudit } from './tools/pattern-handlers.js';
 import { handleRun, handleRunSupervised } from './tools/execution-handlers.js';
 import { handleAgentRegister, handleCheckpoint, handleHandoff, handleAgentDeregister, handleHandoffAccept } from './tools/agent-handlers.js';
@@ -33,7 +36,7 @@ import { handleCheckDeep, handleDeepStats } from './tools/deep-handlers.js';
 import { handleMcpGetSettings, handleMcpSetSettings } from './tools/mcp-settings-handler.js';
 import { handleContextStats, handleTaskCost, handleCacheStats, handleContextExplain, handleContextScope } from './tools/context-handlers.js';
 import { handleIndex } from './tools/index-handlers.js';
-import { recordContextEvent, recordInteractionEvidence, recordInteractionLesson, syncTeamOutbox, estimateTokenCount } from '@rigour-labs/core';
+import { recordContextEvent, recordInteractionEvidence, syncTeamOutbox, estimateTokenCount } from '@rigour-labs/core';
 // ─── Server Setup ─────────────────────────────────────────────────
 const server = new Server({ name: "rigour-mcp", version: getMcpVersion('5.5.0') }, { capabilities: { tools: {}, prompts: {}, logging: {}, resources: {} } });
 function interactionMetadata(args) {
@@ -144,17 +147,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 break;
             // Memory
             case "rigour_remember":
-                result = await handleRemember(cwd, args.key, args.value || args.content);
+                result = await handleRemember(cwd, args.key, args.value || args.content, args.scope);
                 break;
             case "rigour_recall":
-                result = await handleRecall(cwd, args.key);
+                result = await handleRecall(cwd, { key: args.key, query: args.query });
                 break;
             case "rigour_forget":
-                result = await handleForget(cwd, args.key);
+                result = await handleForget(cwd, args.key, args.scope);
                 break;
             // Pattern intelligence
             case "rigour_check_pattern":
-                result = await handleCheckPattern(cwd, args.name, args.type, args.intent, args.file);
+                result = await handleCheckPattern(cwd, args.name, args.type, args.intent, args.file, args.signature, args.keywords);
                 break;
             case "rigour_security_audit":
                 result = await handleSecurityAudit(cwd);
@@ -286,15 +289,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 summary: result?._guidance?.recommendation,
                 ...interactionMetadata(args),
             });
-            await recordInteractionLesson(cwd, {
-                tool: name,
-                outcome,
-                requestId,
-                deterministic,
-                verifiedOutcome: deterministic,
-                summary: result?._guidance?.recommendation,
-                ...interactionMetadata(args),
-            });
             void syncTeamOutbox().catch(() => undefined);
         }
         catch {
@@ -320,6 +314,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             ? `${report.status.toUpperCase()} — Score: ${report.stats?.score ?? '?'}/100`
             : "completed";
         pushTimelineEntry(name, result.isError ? "error" : "success", details);
+        updateKnowledge(await summarizeKnowledge(cwd, { fresh: LEARNING_TOOLS.has(name) }).catch(() => null));
+        seedFromLastReport(await readLastReport(cwd));
         if (report?.stats) {
             updateScore(report.stats.score ?? 0, report.status === "PASS" ? "pass" : "fail", report.stats.severity_breakdown);
         }
@@ -470,6 +466,16 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
             throw new Error(`Unknown prompt: ${name}`);
     }
 });
+/** The last report `rigour check` wrote here (output.report_path), or null. */
+async function readLastReport(cwd) {
+    try {
+        const config = await loadConfig(cwd);
+        return await fs.readJson(path.join(cwd, config.output?.report_path ?? 'rigour-report.json'));
+    }
+    catch {
+        return null;
+    }
+}
 // ─── Start ────────────────────────────────────────────────────────
 async function main() {
     if (process.argv.includes('--gateway')) {
@@ -482,7 +488,7 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     void flushDailyUsage(); // a day's agent activity, if a day has passed; never awaited by the agent
-    console.error("Rigour MCP server v4.0.0 running on stdio");
+    console.error(`Rigour MCP server v${getMcpVersion('unknown')} running on stdio`);
 }
 main().catch((error) => {
     console.error("Fatal error in Rigour MCP server:", error);

package/dist/tools/definitions.d.ts

@@ -157,6 +157,11 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             cwd: {
                 type: "string";
                 description: string;
@@ -181,6 +186,39 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            query: {
+                type: string;
+                description: string;
+            };
+            cwd: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            key: {
+                type: string;
+                description: string;
+            };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             cwd: {
                 type: "string";
                 description: string;
@@ -213,6 +251,17 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            signature: {
+                type: string;
+                description: string;
+            };
+            keywords: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             file: {
                 type: string;
                 description: string;

package/dist/tools/definitions.js

@@ -176,13 +176,14 @@ export const TOOL_DEFINITIONS = [
     // ─── Memory Persistence ───────────────────────────────
     {
         name: "rigour_remember",
-        description: "Store a persistent instruction or context that the AI should remember across sessions. Use this to persist user preferences, project conventions, or critical instructions. IMPORTANT: You must provide both 'key' (a short snake_case identifier) and 'value' (the full text to remember).",
+        description: "Store an instruction or convention to remember across sessions. Provide 'key' (short snake_case) and 'value' (the full text). scope: 'repo' (default, this repository), 'user' (all your repositories), or 'team' (this repository, and shared as a team candidate that teammates' agents receive once a person promotes it). Values containing credentials are refused.",
         inputSchema: {
             type: "object",
             properties: {
                 ...cwdParam(),
                 key: { type: "string", description: "A short snake_case identifier for this memory, e.g. 'api_response_format', 'naming_convention', 'testing_strategy'. This is used to retrieve the memory later." },
                 value: { type: "string", description: "The full instruction or convention text to persist. This is the content that will be recalled in future sessions." },
+                scope: { type: "string", enum: ["repo", "user", "team"], description: "Where the memory applies. Default: repo." },
             },
             required: ["cwd", "key", "value"],
         },
@@ -196,12 +197,13 @@ export const TOOL_DEFINITIONS = [
     },
     {
         name: "rigour_recall",
-        description: "Load project memory and stored conventions. CALL THIS at the START of every coding task (before reading files) to restore team decisions, naming conventions, and architectural preferences. Returns index health status and uses semantic cache on repeat calls — second recall with the same key is served from cache.",
+        description: "Load stored conventions. At the START of a task, call it with 'query' describing the task to get the few memories that match by meaning, plus promoted team knowledge when team mode is on. With 'key' it returns that memory; with neither, every repository and user memory.",
         inputSchema: {
             type: "object",
             properties: {
                 ...cwdParam(),
                 key: { type: "string", description: "Optional. Key of specific memory to retrieve." },
+                query: { type: "string", description: "Optional. What you are about to do, e.g. 'add retry to the payments client'. Returns the closest memories by meaning." },
             },
             required: ["cwd"],
         },
@@ -221,6 +223,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 ...cwdParam(),
                 key: { type: "string", description: "Key of the memory to remove." },
+                scope: { type: "string", enum: ["repo", "user"], description: "Which memory to remove it from. Default: repo." },
             },
             required: ["cwd", "key"],
         },
@@ -243,6 +246,8 @@ export const TOOL_DEFINITIONS = [
                 name: { type: "string", description: "The name of the function, class, or component you want to create." },
                 type: { type: "string", description: "The type of pattern (e.g., 'function', 'component', 'hook', 'type')." },
                 intent: { type: "string", description: "What the code is for (e.g., 'format dates', 'user authentication')." },
+                signature: { type: "string", description: "Optional. The signature you plan to write, e.g. '(items: T[], size: number) => T[][]'. Matches existing code by shape, not only by name." },
+                keywords: { type: "array", items: { type: "string" }, description: "Optional. Words for what it does, e.g. ['retry', 'backoff']." },
                 file: { type: "string", description: "Target file path (relative to cwd) where the code will be written. Used to enforce protected path rules — writes to .github/, rigour.yml, etc. will be BLOCKED." },
             },
             required: ["cwd", "name"],
@@ -633,12 +638,12 @@ export const TOOL_DEFINITIONS = [
     // ─── Pattern Index & Scoped Context ──────────────────
     {
         name: "rigour_index",
-        description: "Build or update the Rigour pattern index (.rigour/patterns.json). CALL THIS when the index is missing or stale — before rigour_context_scope or rigour_check_pattern. One AST pass extracts functions, classes, routes, and signatures for reuse. Use semantic=true for embedding-based search.",
+        description: "Build or update the Rigour pattern index (.rigour/patterns.json). CALL THIS when the index is missing or stale — before rigour_context_scope or rigour_check_pattern. One AST pass extracts functions, classes, routes, and signatures for reuse, embedded locally so rigour_check_pattern can match by intent; semantic=false skips the embeddings.",
         inputSchema: {
             type: "object",
             properties: {
                 ...cwdParam(),
-                semantic: { type: "boolean", description: "Generate semantic embeddings for better matching (requires Transformers.js). Default: false." },
+                semantic: { type: "boolean", description: "Embed patterns so an intent can find them (local Transformers.js model). Default: true; false records an explicit opt-out." },
                 force: { type: "boolean", description: "Force a full rebuild instead of incremental update. Default: false." },
                 output: { type: "string", description: "Custom path for the index file." },
             },