@miragon/design-iq-mcp 5.4.0 → 5.6.0

package/README.md

@@ -1,8 +1,9 @@
 # @miragon/design-iq-mcp
 
-designIQ's read-only MCP server: it exposes the models of a designIQ content repo — processes
-(BPMN), decisions (DMN), Wardley Maps, Team Topologies, Event Storming boards, Context Maps,
-Value Chains, Markdown and Mermaid diagrams — to any MCP client (Claude Code, Claude Desktop, IDEs, ...). A
+designIQ's read-only MCP server: it exposes the models of a designIQ content repo to any MCP
+client (Claude Code, Claude Desktop, IDEs, ...): processes (BPMN), decisions (DMN), Wardley
+Maps, Team Topologies, Event Storming boards, Context Maps, Value Chains and Markdown
+documents, their diagrams as `mermaid` fences. A
 content repo is a root `designiq.yml` naming its models folder (`models:`, legacy alias
 `processes:`; the legacy file name `bpmiq.yml` is still read); a model IS a file with a
 registered notation extension there (a process its `.bpmn`). Views are **derived from the

package/dist/http.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-Dtk-I0bV.js";
+import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-BdyXTS1w.js";
 import { createServer } from "node:http";
 import { timingSafeEqual } from "node:crypto";
 import { NodeStreamableHTTPServerTransport } from "@modelcontextprotocol/node";

package/dist/server.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-Dtk-I0bV.js";
+import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-BdyXTS1w.js";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";

package/dist/{tools-Dtk-I0bV.js → tools-BdyXTS1w.js}

@@ -178,18 +178,6 @@ const NOTATIONS = [
 		mediaKind: "markdown",
 		docShape: "text",
 		monacoLanguage: "markdown"
-	},
-	{
-		id: "mermaid",
-		label: "Mermaid",
-		noun: {
-			singular: "diagram",
-			plural: "diagrams"
-		},
-		extensions: [".mmd", ".mermaid"],
-		mediaKind: "dsl",
-		docShape: "text",
-		monacoLanguage: "plaintext"
 	}
 ];
 function byId(id) {
@@ -552,20 +540,23 @@ function extractWardley(raw) {
 }
 function extractTeamTopology(raw) {
 	const data = JSON.parse(raw);
+	const list = (v) => Array.isArray(v) ? v : [];
+	const teams = list(data.nodes).map((n) => ({
+		id: n.id,
+		type: n.type ?? "team",
+		name: n.label ?? n.name,
+		extra: n.description ? { description: n.description } : void 0
+	}));
+	const interactions = list(data.interactions).filter((i) => i !== null && typeof i === "object" && "position" in i && "size" in i).map((i) => ({
+		id: i.id,
+		type: "interaction",
+		name: i.label,
+		extra: { mode: i.mode }
+	}));
 	return {
 		notation: "team-topology",
-		nodes: (data.nodes ?? []).map((n) => ({
-			id: n.id,
-			type: n.type ?? "team",
-			name: n.label ?? n.name,
-			extra: n.description ? { description: n.description } : void 0
-		})),
-		edges: (data.edges ?? []).map((e, i) => ({
-			id: e.id ?? `edge-${i}`,
-			from: e.source ?? e.from,
-			to: e.target ?? e.to,
-			kind: e.interaction ?? e.type ?? "interaction"
-		}))
+		nodes: [...teams, ...interactions],
+		edges: []
 	};
 }
 const STORM_ID_PREFIX = {
@@ -816,7 +807,7 @@ function extractValueChain(raw) {
 		nodes: (data.elements ?? []).map((el) => ({
 			id: el.id,
 			type: el.elementType ?? "element",
-			name: el.label ?? el.name
+			name: el.name
 		})),
 		edges: (data.connections ?? []).map((c, i) => ({
 			id: c.id ?? `conn-${i}`,
@@ -1122,6 +1113,15 @@ const READ = {
 	readOnlyHint: true,
 	openWorldHint: false
 };
+/**
+* Where a diagram goes: ONE text in both servers' instructions (the Live
+* Host's and the read-only server's), so the two never steer an assistant two
+* ways. A Mermaid diagram is a fence in a Markdown document; a process, a
+* decision or a model of any other notation is a model of its own (the
+* instructions list the notations just before this). It names no tool, so it
+* holds in every mode the instructions' drift tests run.
+*/
+const DIAGRAMS_IN_DOCUMENTS = "A Mermaid diagram (a diagram as code) goes into a Markdown document as a ```mermaid fence, next to the prose that explains it, never into a file of its own. A process, a decision, a Wardley Map or a model in any other notation above is a model of its own: link it from the document when the repository holds it (a relative link such as [Order to cash](order-to-cash.bpmn)), create it as a model when it does not, and never redraw it in Mermaid.";
 //#endregion
 //#region ../notations/derive.ts
 /**
@@ -1359,9 +1359,10 @@ const DERIVERS = {
 		};
 	},
 	"team-topology": (graph) => {
+		const interactions = graph.nodes.filter((n) => n.type === "interaction").length;
 		const stats = {
-			teams: graph.nodes.length,
-			interactions: graph.edges.length
+			teams: graph.nodes.length - interactions,
+			interactions
 		};
 		return {
 			notation: "team-topology",
@@ -1603,6 +1604,7 @@ function readOnlyInstructions(on) {
 	return [
 		"designIQ is a Git-native workspace where teams model their business and their architecture together, live; this server reads one checkout of such a repository and never writes.",
 		`The repository keeps its models as files under the folder its designiq.yml names, one model per file with the file stem as its id, in these notations: ${NOTATION_FILES}.`,
+		DIAGRAMS_IN_DOCUMENTS,
 		"Start with `list_models` to see which models it holds.",
 		"These tools are notation-neutral: `get_view` (the derived structure), `get_model` (the raw graph of nodes and edges), `enumerate_paths` and `find_cycles` (flow analysis where the notation has flow semantics) and `which_models_use` (which models reference a given one).",
 		"BPMN has deeper tooling: `list_processes`, `get_process` (the derived process view: roles, steps, flow, sub-process calls), `who_owns` (ownership from lanes) and `which_processes_use`" + (on.todos ? "; `list_todos` lists the open todos anchored to processes." : "."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miragon/design-iq-mcp",
-  "version": "5.4.0",
+  "version": "5.6.0",
   "description": "Read-only MCP server exposing a designIQ content repo's models — BPMN processes, DMN decisions, Wardley Maps, Team Topologies, Event Storming boards, Context Maps and more — to any MCP client. Discovered from designiq.yml, views derived from the models.",
   "type": "module",
   "license": "MIT",
@@ -49,10 +49,10 @@
   "devDependencies": {
     "@modelcontextprotocol/client": "2.3.1",
     "tsdown": "0.23.1",
-    "@designiq/github-app": "0.1.0",
     "@designiq/contracts": "0.1.0",
     "@designiq/http-kit": "0.1.0",
     "@designiq/mcp-kit": "0.1.0",
+    "@designiq/github-app": "0.1.0",
     "@designiq/notations": "0.1.0"
   },
   "scripts": {