@rigour-labs/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rigour Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const core_1 = require("@rigour-labs/core");
+const server = new index_js_1.Server({
+    name: "rigour-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+async function loadConfig(cwd) {
+    const configPath = path_1.default.join(cwd, "rigour.yml");
+    if (!(await fs_extra_1.default.pathExists(configPath))) {
+        throw new Error("Rigour configuration (rigour.yml) not found. The agent must run `rigour init` first to establish engineering standards.");
+    }
+    const configContent = await fs_extra_1.default.readFile(configPath, "utf-8");
+    return core_1.ConfigSchema.parse(yaml_1.default.parse(configContent));
+}
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "rigour_check_status",
+                description: "Checks the current project state against Rigour engineering gates. Returns PASS/FAIL and a summary of active gates.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        cwd: {
+                            type: "string",
+                            description: "Absolute path to the project root.",
+                        },
+                    },
+                    required: ["cwd"],
+                },
+            },
+            {
+                name: "rigour_get_fix_packet",
+                description: "Retrieves a prioritized 'Fix Packet' containing actionable engineering instructions to resolve quality gate failures. Use this to iteratively improve your solution.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        cwd: {
+                            type: "string",
+                            description: "Absolute path to the project root.",
+                        },
+                    },
+                    required: ["cwd"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const cwd = args?.cwd || process.cwd();
+    try {
+        const config = await loadConfig(cwd);
+        const runner = new core_1.GateRunner(config);
+        const report = await runner.run(cwd);
+        switch (name) {
+            case "rigour_check_status":
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `RIGOUR AUDIT RESULT: ${report.status}\n\nSummary:\n${Object.entries(report.summary).map(([k, v]) => `- ${k}: ${v}`).join("\n")}`,
+                        },
+                    ],
+                };
+            case "rigour_get_fix_packet":
+                if (report.status === "PASS") {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "ALL QUALITY GATES PASSED. The current state meets the required engineering standards.",
+                            },
+                        ],
+                    };
+                }
+                const packet = report.failures.map((f, i) => {
+                    let text = `FIX TASK ${i + 1}: [${f.id.toUpperCase()}] ${f.title}\n`;
+                    text += `   - CONTEXT: ${f.details}\n`;
+                    if (f.files && f.files.length > 0) {
+                        text += `   - TARGET FILES: ${f.files.join(", ")}\n`;
+                    }
+                    if (f.hint) {
+                        text += `   - REFACTORING GUIDANCE: ${f.hint}\n`;
+                    }
+                    return text;
+                }).join("\n---\n");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `ENGINEERING REFINEMENT REQUIRED:\n\nThe project state violated ${report.failures.length} quality gates. You MUST address these failures before declaring the task complete:\n\n${packet}`,
+                        },
+                    ],
+                };
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `RIGOUR ERROR: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Rigour MCP server v1.0.0 running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in Rigour MCP server:", error);
+    process.exit(1);
+});

package/dist/smoke.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/smoke.test.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)('MCP Smoke Test', () => {
+    (0, vitest_1.it)('should pass', async () => {
+        (0, vitest_1.expect)(true).toBe(true);
+    });
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@rigour-labs/mcp",
+  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/erashu212/rigour"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.6.0",
+    "fs-extra": "^11.2.0",
+    "yaml": "^2.8.2",
+    "@rigour-labs/core": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,146 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import fs from "fs-extra";
+import path from "path";
+import yaml from "yaml";
+import { GateRunner, ConfigSchema, Report } from "@rigour-labs/core";
+
+const server = new Server(
+    {
+        name: "rigour-mcp",
+        version: "1.0.0",
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
+    }
+);
+
+async function loadConfig(cwd: string) {
+    const configPath = path.join(cwd, "rigour.yml");
+    if (!(await fs.pathExists(configPath))) {
+        throw new Error("Rigour configuration (rigour.yml) not found. The agent must run `rigour init` first to establish engineering standards.");
+    }
+    const configContent = await fs.readFile(configPath, "utf-8");
+    return ConfigSchema.parse(yaml.parse(configContent));
+}
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "rigour_check_status",
+                description: "Checks the current project state against Rigour engineering gates. Returns PASS/FAIL and a summary of active gates.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        cwd: {
+                            type: "string",
+                            description: "Absolute path to the project root.",
+                        },
+                    },
+                    required: ["cwd"],
+                },
+            },
+            {
+                name: "rigour_get_fix_packet",
+                description: "Retrieves a prioritized 'Fix Packet' containing actionable engineering instructions to resolve quality gate failures. Use this to iteratively improve your solution.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        cwd: {
+                            type: "string",
+                            description: "Absolute path to the project root.",
+                        },
+                    },
+                    required: ["cwd"],
+                },
+            },
+        ],
+    };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const cwd = (args as any)?.cwd || process.cwd();
+
+    try {
+        const config = await loadConfig(cwd);
+        const runner = new GateRunner(config);
+        const report = await runner.run(cwd);
+
+        switch (name) {
+            case "rigour_check_status":
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `RIGOUR AUDIT RESULT: ${report.status}\n\nSummary:\n${Object.entries(report.summary).map(([k, v]) => `- ${k}: ${v}`).join("\n")}`,
+                        },
+                    ],
+                };
+
+            case "rigour_get_fix_packet":
+                if (report.status === "PASS") {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "ALL QUALITY GATES PASSED. The current state meets the required engineering standards.",
+                            },
+                        ],
+                    };
+                }
+
+                const packet = report.failures.map((f, i) => {
+                    let text = `FIX TASK ${i + 1}: [${f.id.toUpperCase()}] ${f.title}\n`;
+                    text += `   - CONTEXT: ${f.details}\n`;
+                    if (f.files && f.files.length > 0) {
+                        text += `   - TARGET FILES: ${f.files.join(", ")}\n`;
+                    }
+                    if (f.hint) {
+                        text += `   - REFACTORING GUIDANCE: ${f.hint}\n`;
+                    }
+                    return text;
+                }).join("\n---\n");
+
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `ENGINEERING REFINEMENT REQUIRED:\n\nThe project state violated ${report.failures.length} quality gates. You MUST address these failures before declaring the task complete:\n\n${packet}`,
+                        },
+                    ],
+                };
+
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    } catch (error: any) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `RIGOUR ERROR: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Rigour MCP server v1.0.0 running on stdio");
+}
+
+main().catch((error) => {
+    console.error("Fatal error in Rigour MCP server:", error);
+    process.exit(1);
+});

package/src/smoke.test.ts

@@ -0,0 +1,7 @@
+import { describe, it, expect } from 'vitest';
+
+describe('MCP Smoke Test', () => {
+    it('should pass', async () => {
+        expect(true).toBe(true);
+    });
+});

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "dist",
+        "rootDir": "src"
+    },
+    "include": [
+        "src/**/*"
+    ]
+}