@endiagram/mcp 0.1.17 → 0.2.1

package/README.md

@@ -1,8 +1,6 @@
 # @endiagram/mcp
 
-MCP server for [EN Diagram](https://endiagram.com) — structural analysis powered by deterministic graph algorithms.
-
-Write your system in plain text. Get back structural facts: bottlenecks, blast radius, flow landmarks, concurrency groups, and more. No AI inside the computation — every result is deterministic.
+MCP server for [EN Diagram](https://endiagram.com) — deterministic structural analysis powered by graph theory. Every result is backed by a named mathematical theorem. No AI inside the computation.
 
 ## Installation
 
@@ -80,25 +78,34 @@ smithery mcp add dushyant30suthar/endiagram
 
 | Tool | Description |
 |------|-------------|
-| `analyze_system` | Structural signal — computes topology, roles, antipatterns from EN source |
-| `render` | Render a dependency graph as publication-quality SVG |
-| `detail` | Deep structural analysis — concurrency, flow landmarks, resilience, dominator tree, min-cuts |
-| `distance` | Shortest path between two nodes with subsystem crossing annotations |
-| `diff` | Structural diff between two systems — topology, role, and subsystem changes |
-| `trace` | Follow directed flow from node A to node B with role and subsystem annotations |
-| `extract` | Extract a named subsystem as standalone EN source code |
-| `impact` | Blast radius — remove a node and see what disconnects |
-| `evolve` | Dry-run architectural changes — apply a patch and see the structural delta |
-| `between` | Betweenness centrality — what fraction of all shortest paths flow through a node |
+| `analyze` | System overview: shape, node roles, single points of failure, failure threshold, flow hotspots |
+| `detail` | Concurrency, critical path, flow landmarks, resilience, dependency chains, dominator tree |
 | `categorize` | Auto-discover subsystem boundaries from dependency structure |
-| `compose` | Merge two EN graphs into one with entity linking |
+| `distance` | Structural distance between two nodes with the path between them |
+| `diff` | Compare two systems — what changed structurally |
+| `trace` | Follow directed flow from A to B, optional defense node coverage check |
+| `between` | How much of the system flows through a specific node |
+| `extract` | Extract a subsystem as standalone EN source |
+| `impact` | What changes if a node is removed, includes propagation |
+| `evolve` | Dry-run a structural change before making it |
+| `compose` | Merge two systems into one by linking shared entities |
+| `conserve` | Structural invariants, deadlock analysis, complexity, resilience |
+| `render` | SVG diagram |
 
 ## EN Syntax
 
+One statement per line:
+
 ```
-Customer do: place order needs: menu yields: order
-Kitchen do: prepare food needs: order yields: meal
-Waiter do: deliver needs: meal yields: served customer
+actor do: action needs: input1, input2 yields: output1, output2
+```
+
+Shared names between yields and needs create connections automatically:
+
+```
+customer do: place order needs: menu yields: order
+kitchen do: prepare food needs: order yields: meal
+waiter do: deliver needs: meal yields: served customer
 ```
 
 Learn more at [endiagram.com](https://endiagram.com).
@@ -106,4 +113,3 @@ Learn more at [endiagram.com](https://endiagram.com).
 ## License
 
 MIT
-

package/dist/index.js

@@ -2,6 +2,8 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
 const EN_API_URL = process.env.EN_API_URL ?? "https://api.endiagram.com";
 async function callApi(toolName, args) {
     try {
@@ -10,14 +12,24 @@ async function callApi(toolName, args) {
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(args),
         });
-        const text = await response.text();
+        const body = await response.text();
         if (!response.ok) {
             return {
-                text: `API error (${response.status}): ${text}`,
+                text: `API error (${response.status}): ${body}`,
                 isError: true,
             };
         }
-        return { text, isError: false };
+        try {
+            const parsed = JSON.parse(body);
+            return {
+                text: parsed.text ?? body,
+                isError: parsed.isError ?? false,
+                svg: parsed.svg ?? undefined,
+            };
+        }
+        catch {
+            return { text: body, isError: false };
+        }
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown error";
@@ -36,7 +48,9 @@ Shared names between yields and needs create connections automatically. Multi-wo
 
 The engine computes structural truth from the description — the tool outputs are raw mathematical findings. Translate them into clear, practical insights relevant to what the user is trying to achieve.
 
-How to use these tools effectively: model the system first, then explore. The first tool call reveals the structure — but the real insights come from following up. A node labeled HUB that should be simple? Dig into it with between or impact. A surprising subsystem boundary? Extract it and analyze deeper. An unexpected dependency chain? Trace it. A proposed change? Evolve it and diff. The tools are designed to chain — each finding opens a question that another tool can answer. Don't stop at one call. Explore, tinker, compare, and let the math surface what no one expected.`;
+How to use these tools effectively: model the system first, then explore. The first tool call reveals the structure — but the real insights come from following up. A node labeled HUB that should be simple? Dig into it with between or impact. A surprising subsystem boundary? Extract it and analyze deeper. An unexpected dependency chain? Trace it. A proposed change? Evolve it and diff. The tools are designed to chain — each finding opens a question that another tool can answer. Don't stop at one call. Explore, tinker, compare, and let the math surface what no one expected.
+
+Go deep, not wide. When a finding catches your attention — a surprising hub, an unexpected bottleneck, a structural anomaly — lock onto it. Use one tool to surface it, then chain the next tool to explain it, then the next to stress-test it. Keep narrowing until you reach the root. One thread, followed to the end, beats ten shallow observations. Only call render when the user explicitly asks to visualize.`;
 const server = new McpServer({
     name: "endiagram",
     version: "0.2.0",
@@ -196,7 +210,7 @@ server.tool("conserve", "Structural invariants, deadlock analysis, complexity, a
     };
 });
 // --- render ---
-server.tool("render", "SVG diagram. Only when user asks to visualize.", {
+server.tool("render", "SVG diagram. Only call when user explicitly asks to visualize. Saves SVG to a local file — no SVG content enters the conversation.", {
     source: z.string().describe("EN source code describing the system"),
     theme: z
         .enum(["dark", "light"])
@@ -208,9 +222,20 @@ server.tool("render", "SVG diagram. Only when user asks to visualize.", {
         .describe("Output quality"),
 }, async ({ source, theme, quality }) => {
     const result = await callApi("render", { source, theme, quality });
+    if (result.isError || !result.svg) {
+        return {
+            content: [{ type: "text", text: result.text }],
+            isError: result.isError,
+        };
+    }
+    const outDir = join(process.cwd(), ".endiagram");
+    if (!existsSync(outDir))
+        mkdirSync(outDir, { recursive: true });
+    const filePath = join(outDir, `en-${Date.now()}.svg`);
+    writeFileSync(filePath, result.svg);
     return {
-        content: [{ type: "text", text: result.text }],
-        isError: result.isError,
+        content: [{ type: "text", text: `SVG saved: ${filePath}` }],
+        isError: false,
     };
 });
 // --- start server ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@endiagram/mcp",
-  "version": "0.1.17",
-  "description": "MCP server for EN Diagram — structural analysis for any system",
+  "version": "0.2.1",
+  "description": "MCP server for EN Diagram — deterministic structural analysis backed by named theorems",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -22,8 +22,8 @@
     "zod": "^3.23.0"
   },
   "devDependencies": {
-    "typescript": "^5.5.0",
-    "@types/node": "^20.0.0"
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"