@rigour-labs/mcp 6.7.10 → 6.8.0

package/README.md

@@ -34,6 +34,7 @@ the directory the server started in.
 | `rigour_reviewer_verdict` | What the reviewer last decided for the branch (read-only) |
 | `rigour_check`, `rigour_get_fix_packet` | Run the checks, and get the violations a page at a time |
 | `rigour_index`, `rigour_context_scope`, `rigour_check_pattern` | Find the few files a task needs, and whether a helper already exists |
+| `rigour_brief` | The team's briefing for a task before writing: rules, verified lessons, settled points; at most 10, each cited |
 | `rigour_recall`, `rigour_remember` | Recall and store conventions and lessons |
 
 More groups (agent teams, context, telemetry) are listed with `RIGOUR_MCP_TOOLS`. Every tool:

package/dist/advertised-tools.d.ts

@@ -1,6 +1,6 @@
 export declare const TOOL_GROUPS: {
     /** Load memory, scope context, avoid reinvention, gate and review the change, learn. */
-    readonly core: readonly ["rigour_recall", "rigour_index", "rigour_context_scope", "rigour_check_pattern", "rigour_check", "rigour_review", "rigour_review_ack", "rigour_reviewer_verdict", "rigour_get_fix_packet", "rigour_remember"];
+    readonly core: readonly ["rigour_brief", "rigour_recall", "rigour_index", "rigour_context_scope", "rigour_check_pattern", "rigour_check", "rigour_review", "rigour_review_ack", "rigour_reviewer_verdict", "rigour_get_fix_packet", "rigour_remember"];
     /** Multi-agent registration, checkpoints, handoffs, hooks and supervised runs. */
     readonly governance: readonly ["rigour_agent_register", "rigour_agent_deregister", "rigour_checkpoint", "rigour_handoff", "rigour_handoff_accept", "rigour_hooks_check", "rigour_hooks_init", "rigour_run", "rigour_run_supervised"];
     /** Occasional context and security tools. */
@@ -173,6 +173,37 @@ export declare function getAdvertisedToolDefinitions(spec?: string | undefined,
         idempotentHint: boolean;
         openWorldHint: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            goal: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    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;

package/dist/advertised-tools.js

@@ -16,6 +16,7 @@ import { TOOL_DEFINITIONS } from './tools/definitions.js';
 export const TOOL_GROUPS = {
     /** Load memory, scope context, avoid reinvention, gate and review the change, learn. */
     core: [
+        'rigour_brief',
         'rigour_recall',
         'rigour_index',
         'rigour_context_scope',

package/dist/index.js

@@ -28,6 +28,7 @@ import { getAdvertisedToolDefinitions } from './advertised-tools.js';
 import { handleCheck, handleExplain, handleStatus, handleGetFixPacket, handleListGates, handleGetConfig } from './tools/quality-handlers.js';
 import { handleRemember, handleForget } from './tools/memory-handlers.js';
 import { handleRecall } from './tools/memory-recall.js';
+import { handleBrief } from './tools/brief-handler.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';
@@ -157,6 +158,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "rigour_recall":
                 result = await handleRecall(cwd, { key: args.key, query: args.query });
                 break;
+            case "rigour_brief":
+                result = handleBrief(cwd, config, args);
+                break;
             case "rigour_forget":
                 result = await handleForget(cwd, args.key, args.scope);
                 break;

package/dist/tools/brief-handler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * rigour_brief: the team's briefing for a task, for any agent that speaks MCP (Claude Code gets it from a prompt hook).
+ * Read-only apart from the task thread's record of what was briefed; nothing when the team switched briefings off.
+ */
+import { type Config } from '@rigour-labs/core';
+export declare function handleBrief(cwd: string, config: Config, args: {
+    goal?: string;
+    files?: unknown;
+    agent?: string;
+}): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};

package/dist/tools/brief-handler.js

@@ -0,0 +1,21 @@
+/**
+ * rigour_brief: the team's briefing for a task, for any agent that speaks MCP (Claude Code gets it from a prompt hook).
+ * Read-only apart from the task thread's record of what was briefed; nothing when the team switched briefings off.
+ */
+import { briefFile, briefingText, briefTask, fileBriefingText } from '@rigour-labs/core';
+export function handleBrief(cwd, config, args) {
+    if (config.brief?.enabled === false || /^(0|false|off|no)$/i.test(process.env.RIGOUR_BRIEF?.trim() ?? '')) {
+        return { content: [{ type: 'text', text: 'Briefings are switched off in this repository (brief.enabled: false, or RIGOUR_BRIEF=0).' }] };
+    }
+    const files = Array.isArray(args.files) ? args.files.filter((f) => typeof f === 'string' && !!f.trim()) : undefined;
+    const lessons = config.gates.deep?.review_lessons;
+    const agent = args.agent ?? 'mcp';
+    // Files and no goal: the agent is about to edit them; the team's word on each, like the edit hook (at most three each, ten in all).
+    if (!args.goal?.trim() && files?.length) {
+        const texts = files.slice(0, 10).map(file => fileBriefingText(briefFile(cwd, file, { agent, ...(lessons ? { lessons } : {}) }))).filter(Boolean);
+        return { content: [{ type: 'text', text: texts.join('\n\n') || `Nothing to brief for ${files.join(', ')}: no rule or lesson of this repository names them yet.` }] };
+    }
+    const briefing = briefTask(cwd, { goal: args.goal, ...(files?.length ? { files } : {}), limit: config.brief?.max_items ?? 10, agent, ...(lessons ? { lessons } : {}) });
+    const text = briefingText(briefing) || `Nothing to brief: no rule or verified lesson of this repository applies to ${briefing.files.length ? briefing.files.join(', ') : 'this task'} yet.`;
+    return { content: [{ type: 'text', text }] };
+}

package/dist/tools/definitions.d.ts

@@ -176,6 +176,37 @@ export declare const TOOL_DEFINITIONS: ({
         idempotentHint: boolean;
         openWorldHint: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            goal: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    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;

package/dist/tools/definitions.js

@@ -195,6 +195,26 @@ export const TOOL_DEFINITIONS = [
             openWorldHint: false,
         },
     },
+    {
+        name: "rigour_brief",
+        description: "Before writing: with goal, the team's rules, lessons and settled points for the task (max 10, cited); with only files, its word on each file you will edit. A [must] you break blocks at review.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...cwdParam(),
+                goal: { type: "string", description: "What the task is for: the request or the ticket summary." },
+                files: { type: "array", items: { type: "string" }, description: "Optional. Files the task will touch." },
+            },
+            required: ["cwd"],
+        },
+        annotations: {
+            title: "Brief Before Writing",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
     {
         name: "rigour_recall",
         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.",

package/dist/utils/config.d.ts

@@ -257,6 +257,10 @@ export declare function loadConfig(cwd: string): Promise<{
     output: {
         report_path: string;
     };
+    brief: {
+        enabled: boolean;
+        max_items: number;
+    };
     review: {
         include_heuristics: boolean;
         show_preexisting: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rigour-labs/mcp",
-  "version": "6.7.10",
+  "version": "6.8.0",
   "description": "Rigour's MCP server: lets coding agents review their change, check for an existing helper before writing a new one, and recall the team's lessons. Works with Claude Code, Cursor and other MCP clients.",
   "engines": {
     "node": ">=22.13"
@@ -65,7 +65,7 @@
     "execa": "^8.0.1",
     "fs-extra": "^11.4.0",
     "yaml": "^2.8.2",
-    "@rigour-labs/core": "6.7.10"
+    "@rigour-labs/core": "6.8.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",