@getripple/mcp 1.0.4

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @getripple/mcp Changelog
+
+## [1.0.4] - 2026-06-03
+
+### Fixed
+- Executable entry point for the `ripple-mcp` binary.
+- Publishable package identity under `@getripple/mcp`.
+- Release readiness checks for packed MCP installs and stdio gate behavior.
+- Package-specific README and changelog included in the npm tarball.
+
+## [1.0.3] - 2026-06-03
+
+### Added
+- Initial release of Ripple's MCP stdio server.
+- Agent tools for workflow handshake, context planning, staged/changed checks, audit, gate, approval status, repair, focus, blast radius, policy explanation, and recent changes.
+- Structured continue/stop gate responses for MCP-compatible AI coding agents.
+
+### Notes
+- Public alpha. Agents should treat Ripple's output as local workflow evidence, not as a replacement for tests or human review.

package/README.md

@@ -0,0 +1,84 @@
+# @getripple/mcp
+
+MCP stdio server for AI agents that need Ripple's architectural context before
+editing code.
+
+Paste this into an MCP-compatible client:
+
+```json
+{
+  "mcpServers": {
+    "ripple": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@getripple/mcp",
+        "--workspace",
+        "/absolute/path/to/your/repo"
+      ]
+    }
+  }
+}
+```
+
+The server lets agents call Ripple directly instead of scraping markdown files.
+It does not sandbox file writes by itself; MCP clients, CLI checks, CI gates, or
+human review must obey Ripple's continue/stop decisions.
+
+## Tools
+
+```txt
+ripple_get_agent_workflow
+ripple_doctor
+ripple_plan_context
+ripple_check_staged
+ripple_check_changed
+ripple_audit_change
+ripple_gate
+ripple_get_approval_status
+ripple_repair_intent_drift
+ripple_get_focus
+ripple_get_blast_radius
+ripple_explain_policy
+ripple_get_recent_changes
+```
+
+Use `ripple_plan_context` before editing to save task intent and control
+boundary. Use `ripple_check_staged` or `ripple_audit_change` after editing to
+detect intent drift, boundary drift, policy drift, and readiness drift. Use
+`ripple_gate` when the agent only needs the compact continue/stop decision.
+
+## Local Run
+
+After install:
+
+```bash
+ripple-mcp --workspace /absolute/path/to/your/repo
+```
+
+Without installing:
+
+```bash
+npx -y @getripple/mcp --workspace /absolute/path/to/your/repo
+```
+
+For local monorepo development:
+
+```bash
+npm run build:mcp
+node packages/mcp/dist/server.js --workspace /absolute/path/to/your/repo
+```
+
+## Protocol Notes
+
+The server speaks newline-delimited JSON-RPC over stdio. Only JSON-RPC messages
+are written to stdout; scan logs are redirected to stderr so MCP clients can
+parse responses safely.
+
+## Status
+
+Public alpha. The strongest current experience is JavaScript and TypeScript.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { RippleMcpToolHost, createRippleMcpToolHost, RIPPLE_MCP_TOOLS, } from "./tools";
+export type { RippleMcpToolName, RippleMcpToolDefinition, RippleMcpToolCallArgs, RippleMcpToolResult, RippleMcpToolHostOptions, } from "./tools";
+export { MCP_PROTOCOL_VERSION, RippleMcpJsonRpcServer, runStdioServer, } from "./server";
+export type { JsonRpcResponse, } from "./server";

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStdioServer = exports.RippleMcpJsonRpcServer = exports.MCP_PROTOCOL_VERSION = exports.RIPPLE_MCP_TOOLS = exports.createRippleMcpToolHost = exports.RippleMcpToolHost = void 0;
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "RippleMcpToolHost", { enumerable: true, get: function () { return tools_1.RippleMcpToolHost; } });
+Object.defineProperty(exports, "createRippleMcpToolHost", { enumerable: true, get: function () { return tools_1.createRippleMcpToolHost; } });
+Object.defineProperty(exports, "RIPPLE_MCP_TOOLS", { enumerable: true, get: function () { return tools_1.RIPPLE_MCP_TOOLS; } });
+var server_1 = require("./server");
+Object.defineProperty(exports, "MCP_PROTOCOL_VERSION", { enumerable: true, get: function () { return server_1.MCP_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "RippleMcpJsonRpcServer", { enumerable: true, get: function () { return server_1.RippleMcpJsonRpcServer; } });
+Object.defineProperty(exports, "runStdioServer", { enumerable: true, get: function () { return server_1.runStdioServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAIiB;AAHf,0GAAA,iBAAiB,OAAA;AACjB,gHAAA,uBAAuB,OAAA;AACvB,yGAAA,gBAAgB,OAAA;AAWlB,mCAIkB;AAHhB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA;AACtB,wGAAA,cAAc,OAAA"}

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { RippleMcpToolHost } from "./tools";
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+type JsonRpcId = string | number | null;
+type JsonRpcSuccessResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result: unknown;
+};
+type JsonRpcErrorResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+};
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+export declare class RippleMcpJsonRpcServer {
+    private readonly host;
+    private readonly version;
+    constructor(host: RippleMcpToolHost, version?: string);
+    handleLine(line: string): Promise<JsonRpcResponse | null>;
+    handleMessage(message: unknown): Promise<JsonRpcResponse | null>;
+    dispose(): void;
+    private initializeResult;
+    private callToolResult;
+    private success;
+    private error;
+}
+export declare function runStdioServer(workspaceRoot: string): Promise<void>;
+export {};

package/dist/server.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStdioServer = exports.RippleMcpJsonRpcServer = exports.MCP_PROTOCOL_VERSION = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const tools_1 = require("./tools");
+exports.MCP_PROTOCOL_VERSION = "2025-06-18";
+const JSON_RPC_VERSION = "2.0";
+const SERVER_NAME = "ripple-mcp";
+const JSON_RPC_ERRORS = {
+    parseError: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+    internalError: -32603,
+};
+class RippleMcpJsonRpcServer {
+    constructor(host, version = readPackageVersion()) {
+        this.host = host;
+        this.version = version;
+    }
+    async handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch (err) {
+            return this.error(null, JSON_RPC_ERRORS.parseError, "Parse error", errorMessage(err));
+        }
+        return this.handleMessage(message);
+    }
+    async handleMessage(message) {
+        if (!isJsonRpcRequest(message)) {
+            return this.error(null, JSON_RPC_ERRORS.invalidRequest, "Invalid Request");
+        }
+        const id = message.id ?? null;
+        const isNotification = message.id === undefined;
+        if (message.method === "notifications/initialized") {
+            return null;
+        }
+        if (!message.method) {
+            return isNotification
+                ? null
+                : this.error(id, JSON_RPC_ERRORS.invalidRequest, "Request method is required.");
+        }
+        try {
+            if (message.method === "initialize") {
+                return isNotification ? null : this.success(id, this.initializeResult());
+            }
+            if (message.method === "ping") {
+                return isNotification ? null : this.success(id, {});
+            }
+            if (message.method === "tools/list") {
+                return isNotification
+                    ? null
+                    : this.success(id, { tools: this.host.listTools() });
+            }
+            if (message.method === "tools/call") {
+                return isNotification
+                    ? null
+                    : this.success(id, await this.callToolResult(message.params));
+            }
+            return isNotification
+                ? null
+                : this.error(id, JSON_RPC_ERRORS.methodNotFound, `Method not found: ${message.method}`);
+        }
+        catch (err) {
+            return this.error(id, JSON_RPC_ERRORS.internalError, errorMessage(err));
+        }
+    }
+    dispose() {
+        this.host.dispose();
+    }
+    initializeResult() {
+        return {
+            protocolVersion: exports.MCP_PROTOCOL_VERSION,
+            capabilities: {
+                tools: {
+                    listChanged: false,
+                },
+            },
+            serverInfo: {
+                name: SERVER_NAME,
+                title: "Ripple MCP",
+                version: this.version,
+            },
+            instructions: "Use Ripple before editing code to get focused architectural context, blast radius, recent changes, and token-budgeted read plans.",
+        };
+    }
+    async callToolResult(params) {
+        const parsed = parseToolCallParams(params);
+        if (!isRippleMcpToolName(parsed.name)) {
+            throw new Error(`Unknown Ripple MCP tool: ${String(parsed.name)}`);
+        }
+        try {
+            const result = await this.host.callTool(parsed.name, parsed.arguments);
+            const text = JSON.stringify(result.data, null, 2);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text,
+                    },
+                ],
+                structuredContent: result.data,
+                isError: false,
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: errorMessage(err),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    success(id, result) {
+        return {
+            jsonrpc: JSON_RPC_VERSION,
+            id,
+            result,
+        };
+    }
+    error(id, code, message, data) {
+        return {
+            jsonrpc: JSON_RPC_VERSION,
+            id,
+            error: {
+                code,
+                message,
+                ...(data === undefined ? {} : { data }),
+            },
+        };
+    }
+}
+exports.RippleMcpJsonRpcServer = RippleMcpJsonRpcServer;
+async function runStdioServer(workspaceRoot) {
+    const originalLog = console.log;
+    console.log = (...args) => {
+        console.error(...args);
+    };
+    const host = (0, tools_1.createRippleMcpToolHost)({ workspaceRoot });
+    const server = new RippleMcpJsonRpcServer(host);
+    const lines = readline.createInterface({
+        input: process.stdin,
+        crlfDelay: Infinity,
+    });
+    const writeResponse = (response) => {
+        if (!response) {
+            return;
+        }
+        process.stdout.write(`${JSON.stringify(response)}\n`);
+    };
+    let queue = Promise.resolve();
+    const handleInputLine = async (line) => {
+        try {
+            writeResponse(await server.handleLine(line));
+        }
+        catch (err) {
+            writeResponse({
+                jsonrpc: JSON_RPC_VERSION,
+                id: null,
+                error: {
+                    code: JSON_RPC_ERRORS.internalError,
+                    message: errorMessage(err),
+                },
+            });
+        }
+    };
+    lines.on("line", (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            return;
+        }
+        queue = queue.then(() => handleInputLine(trimmed));
+    });
+    lines.on("close", () => {
+        void queue.finally(() => {
+            server.dispose();
+            console.log = originalLog;
+        });
+    });
+}
+exports.runStdioServer = runStdioServer;
+function parseToolCallParams(params) {
+    if (!isRecord(params)) {
+        throw new Error("tools/call params must be an object.");
+    }
+    const toolParams = params;
+    if (!isRecord(toolParams.arguments)) {
+        throw new Error("tools/call arguments must be an object.");
+    }
+    return {
+        name: toolParams.name,
+        arguments: toolParams.arguments,
+    };
+}
+function isRippleMcpToolName(name) {
+    return (name === "ripple_doctor" ||
+        name === "ripple_check_changed" ||
+        name === "ripple_check_staged" ||
+        name === "ripple_audit_change" ||
+        name === "ripple_gate" ||
+        name === "ripple_get_approval_status" ||
+        name === "ripple_get_agent_workflow" ||
+        name === "ripple_repair_intent_drift" ||
+        name === "ripple_get_focus" ||
+        name === "ripple_get_blast_radius" ||
+        name === "ripple_explain_policy" ||
+        name === "ripple_plan_context" ||
+        name === "ripple_get_recent_changes");
+}
+function isJsonRpcRequest(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    const request = value;
+    const id = request.id;
+    return (request.jsonrpc === JSON_RPC_VERSION &&
+        (id === undefined || typeof id === "string" || typeof id === "number" || id === null) &&
+        (request.method === undefined || typeof request.method === "string"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function readPackageVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, "..", "package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function resolveWorkspaceRoot(argv) {
+    const envRoot = process.env.RIPPLE_WORKSPACE_ROOT;
+    let root = envRoot && envRoot.trim().length > 0 ? envRoot : process.cwd();
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (token === "--help" || token === "-h") {
+            process.stdout.write([
+                "Ripple MCP stdio server",
+                "",
+                "Usage:",
+                "  ripple-mcp [--workspace <path>]",
+                "",
+                "Environment:",
+                "  RIPPLE_WORKSPACE_ROOT  Workspace root used when --workspace is not provided",
+                "",
+            ].join("\n"));
+            process.exit(0);
+        }
+        if (token === "--workspace") {
+            const value = argv[i + 1];
+            if (!value || value.startsWith("-")) {
+                throw new Error("Missing value for --workspace");
+            }
+            root = value;
+            i++;
+            continue;
+        }
+        if (token.startsWith("--workspace=")) {
+            root = token.slice("--workspace=".length);
+            continue;
+        }
+        throw new Error(`Unknown argument: ${token}`);
+    }
+    return path.resolve(root);
+}
+if (require.main === module) {
+    try {
+        void runStdioServer(resolveWorkspaceRoot(process.argv.slice(2)));
+    }
+    catch (err) {
+        console.error(`Ripple MCP error: ${errorMessage(err)}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,62 @@
+import { AgentWorkflowSummary, ChangeIntent, ContextPlanSummary, FileBlastRadiusSummary, FileFocusSummary, IntentDriftRepairPlan, RippleApprovalStatus, RippleAuditSummary, RippleGateSummary, RipplePolicyExplanation, RecentHistorySummary, RippleReadinessSummary, StagedCheckSummary, StagedCheckWithIntentSummary } from "@getripple/core";
+export type RippleMcpToolName = "ripple_doctor" | "ripple_check_changed" | "ripple_check_staged" | "ripple_audit_change" | "ripple_gate" | "ripple_get_approval_status" | "ripple_get_agent_workflow" | "ripple_repair_intent_drift" | "ripple_get_focus" | "ripple_get_blast_radius" | "ripple_explain_policy" | "ripple_plan_context" | "ripple_get_recent_changes";
+export type RippleMcpToolDefinition = {
+    name: RippleMcpToolName;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties: false;
+    };
+};
+export type RippleMcpToolHostOptions = {
+    workspaceRoot: string;
+};
+export type RippleMcpToolCallArgs = Record<string, unknown>;
+export type RippleMcpToolData = AgentWorkflowSummary | RippleReadinessSummary | FileFocusSummary | FileBlastRadiusSummary | ContextPlanSummary | ContextPlanWithIntentSummary | RipplePolicyExplanation | ApprovalStatusWithIntentSummary | RippleAuditSummary | RippleGateSummary | IntentDriftRepairPlan | RecentHistorySummary | StagedCheckSummary | StagedCheckWithIntentSummary;
+export type RippleMcpToolResult<T = RippleMcpToolData> = {
+    tool: RippleMcpToolName;
+    data: T;
+};
+export type ContextPlanWithIntentSummary = ContextPlanSummary & {
+    policyExplanation: RipplePolicyExplanation;
+    changeIntent?: ChangeIntent;
+    changeIntentPath?: string;
+};
+export type ApprovalStatusWithIntentSummary = RippleApprovalStatus & {
+    intent: {
+        id: string;
+        task: string;
+        targetFile: string;
+        controlMode: ChangeIntent["controlMode"];
+        humanGate: ChangeIntent["humanGate"];
+        boundaryRisk: ChangeIntent["boundaryRisk"];
+    };
+};
+export declare const RIPPLE_MCP_TOOLS: RippleMcpToolDefinition[];
+export declare class RippleMcpToolHost {
+    private readonly workspaceRoot;
+    private readonly engine;
+    private scanned;
+    constructor(options: RippleMcpToolHostOptions);
+    listTools(): RippleMcpToolDefinition[];
+    initialize(): Promise<void>;
+    dispose(): void;
+    callTool(name: RippleMcpToolName, args?: RippleMcpToolCallArgs): Promise<RippleMcpToolResult>;
+    private getFocus;
+    private getReadiness;
+    private getBlastRadius;
+    private explainPolicy;
+    private planContext;
+    private getRecentChanges;
+    private getApprovalStatus;
+    private checkStaged;
+    private checkChanged;
+    private auditChange;
+    private gateChange;
+    private repairIntentDrift;
+    private currentPolicyExplanationForIntent;
+    private currentReadinessSnapshot;
+}
+export declare function createRippleMcpToolHost(options: RippleMcpToolHostOptions): RippleMcpToolHost;