@miragon/design-iq-mcp 5.9.0 → 5.11.0

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-DizBhl75.js";
+import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-CszDSqzk.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-DizBhl75.js";
+import { n as createMcpServer, r as todosConfigFromEnv, t as DEFAULT_ROOT } from "./tools-CszDSqzk.js";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";

package/dist/{tools-DizBhl75.js → tools-CszDSqzk.js}

@@ -68,6 +68,7 @@ const NOTATIONS = [
 		mediaKind: "xml",
 		docShape: "text",
 		monacoLanguage: "xml",
+		todos: true,
 		graphHints: {
 			flowEdgeKinds: ["sequenceFlow"],
 			entryNodeTypes: ["startEvent"]
@@ -100,6 +101,7 @@ const NOTATIONS = [
 		mediaKind: "dsl",
 		docShape: "text",
 		monacoLanguage: "plaintext",
+		todos: true,
 		graphHints: {
 			flowEdgeKinds: ["dependency"],
 			entryNodeTypes: []
@@ -115,7 +117,8 @@ const NOTATIONS = [
 		extensions: [".tt", ".ttm.json"],
 		mediaKind: "json",
 		docShape: "text",
-		monacoLanguage: "json"
+		monacoLanguage: "json",
+		todos: true
 	},
 	{
 		id: "event-storming",
@@ -128,6 +131,7 @@ const NOTATIONS = [
 		mediaKind: "dsl",
 		docShape: "text",
 		monacoLanguage: "plaintext",
+		todos: true,
 		graphHints: {
 			flowEdgeKinds: ["arrow"],
 			entryNodeTypes: []
@@ -144,6 +148,7 @@ const NOTATIONS = [
 		mediaKind: "json",
 		docShape: "text",
 		monacoLanguage: "json",
+		todos: true,
 		graphHints: {
 			flowEdgeKinds: [
 				"partnership",
@@ -177,7 +182,8 @@ const NOTATIONS = [
 		extensions: [".md"],
 		mediaKind: "markdown",
 		docShape: "text",
-		monacoLanguage: "markdown"
+		monacoLanguage: "markdown",
+		todos: true
 	}
 ];
 function byId(id) {
@@ -542,6 +548,8 @@ const TT_EDGE_INTERACTIONS_VERSION = 1;
 function extractTeamTopology(raw) {
 	const data = JSON.parse(raw);
 	const list = (v) => Array.isArray(v) ? v : [];
+	const objects = (v) => list(v).filter((i) => i !== null && typeof i === "object");
+	const text = (v) => typeof v === "string" && v !== "" ? v : void 0;
 	const teams = list(data.nodes).map((n) => ({
 		id: n.id,
 		type: n.type ?? "team",
@@ -549,16 +557,38 @@ function extractTeamTopology(raw) {
 		extra: n.description ? { description: n.description } : void 0
 	}));
 	const placed = (i) => "position" in i && "size" in i;
-	const interactions = list(data.interactions).filter((i) => i !== null && typeof i === "object").filter((i) => data.version !== TT_EDGE_INTERACTIONS_VERSION || placed(i)).map((i) => ({
+	const interactions = objects(data.interactions).filter((i) => data.version !== TT_EDGE_INTERACTIONS_VERSION || placed(i)).map((i) => ({
 		id: i.id,
 		type: "interaction",
 		name: i.label,
 		extra: { mode: i.mode }
 	}));
+	const flows = objects(data.flows).map((f) => ({
+		id: f.id,
+		type: "flow",
+		name: text(f.label)
+	}));
+	const attachable = new Set([
+		...teams,
+		...interactions,
+		...flows
+	].map((n) => n.id));
+	const annotations = objects(data.annotations).map((a) => ({
+		id: a.id,
+		type: "annotation",
+		name: text(a.text),
+		extra: typeof a.attachedTo === "string" && attachable.has(a.attachedTo) ? { attachedTo: a.attachedTo } : void 0
+	}));
 	return {
 		notation: "team-topology",
-		nodes: [...teams, ...interactions],
-		edges: []
+		nodes: [
+			...teams,
+			...interactions,
+			...flows,
+			...annotations
+		],
+		edges: [],
+		meta: { title: text(data.title) ?? null }
 	};
 }
 const STORM_ID_PREFIX = {
@@ -1033,7 +1063,8 @@ function parseAnchor(text) {
 	const end = text.indexOf(CLOSE, start);
 	if (end === -1) return null;
 	const anchor = {
-		process: "",
+		notation: "",
+		model: "",
 		file: null,
 		elements: [],
 		processVersion: null
@@ -1044,7 +1075,8 @@ function parseAnchor(text) {
 		if (sep === -1) continue;
 		const key = line.slice(0, sep);
 		const value = line.slice(sep + 2).trim();
-		if (key === "process") anchor.process = value;
+		if (key === "model") anchor.model = value;
+		else if (key === "notation") anchor.notation = value;
 		else if (key === "file") anchor.file = value;
 		else if (key === "version") anchor.processVersion = value;
 		else if (key === "type") {
@@ -1067,7 +1099,7 @@ function parseAnchor(text) {
 			});
 		}
 	}
-	return anchor.process ? anchor : null;
+	return anchor.notation && anchor.model ? anchor : null;
 }
 //#endregion
 //#region ../github-app/src/todos.ts
@@ -1083,10 +1115,12 @@ function parseAnchor(text) {
 */
 /** the label every platform-managed todo carries */
 const TODO_LABEL = "todo";
-/** the per-process label that makes the tracker-side filter cheap */
-const processLabel = (processId) => `process:${processId}`;
-/** the `labels=` filter for listing: every todo, or one process's */
-const todoLabelQuery = (processId) => processId ? `${TODO_LABEL},${processLabel(processId)}` : TODO_LABEL;
+/** the per-model label that makes the tracker-side filter cheap:
+*  `<notation>:<id>` (`bpmn:order-to-cash`, `wardley:tea-shop`) — ids are
+*  unique per notation only */
+const modelLabel = (model) => `${model.notation}:${model.id}`;
+/** the `labels=` filter for listing: every todo, or one model's */
+const todoLabelQuery = (model) => model ? `${TODO_LABEL},${modelLabel(model)}` : TODO_LABEL;
 const isPullRequestRow = (row) => row.pull_request !== void 0;
 //#endregion
 //#region ../mcp-kit/index.ts
@@ -1369,16 +1403,55 @@ const DERIVERS = {
 		};
 	},
 	"team-topology": (graph) => {
-		const interactions = graph.nodes.filter((n) => n.type === "interaction").length;
+		const ofType = (type) => graph.nodes.filter((n) => n.type === type);
+		const interactions = ofType("interaction");
+		const flows = ofType("flow");
+		const annotations = ofType("annotation");
+		const teams = graph.nodes.filter((n) => ![
+			"interaction",
+			"flow",
+			"annotation"
+		].includes(n.type));
 		const stats = {
-			teams: graph.nodes.length - interactions,
-			interactions
+			teams: teams.length,
+			interactions: interactions.length,
+			flows: flows.length,
+			annotations: annotations.length
+		};
+		const shown = {
+			teams: stats.teams,
+			interactions: stats.interactions,
+			...stats.flows > 0 ? { flows: stats.flows } : {},
+			...stats.annotations > 0 ? { annotations: stats.annotations } : {}
 		};
+		const title = graph.meta?.title;
 		return {
 			notation: "team-topology",
-			name: null,
-			summary: `Team Topology with ${counted(stats)}`,
-			stats
+			name: typeof title === "string" ? title : null,
+			summary: `Team Topology with ${counted(shown)}`,
+			stats,
+			detail: {
+				teams: teams.map((n) => ({
+					id: n.id,
+					label: n.name ?? null,
+					type: n.type,
+					description: n.extra?.description ?? null
+				})),
+				interactions: interactions.map((n) => ({
+					id: n.id,
+					label: n.name ?? null,
+					mode: n.extra?.mode ?? null
+				})),
+				flows: flows.map((n) => ({
+					id: n.id,
+					label: n.name ?? null
+				})),
+				annotations: annotations.map((n) => ({
+					id: n.id,
+					text: n.name ?? null,
+					attachedTo: n.extra?.attachedTo ?? null
+				}))
+			}
 		};
 	},
 	"event-storming": (graph) => {
@@ -1617,7 +1690,7 @@ function readOnlyInstructions(on) {
 		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." : "."),
+		"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 filed on models and their elements." : "."),
 		"Live editing, the modeler widgets and release as a pull request are on the designIQ Live Host, not here."
 	].join(" ");
 }
@@ -1908,14 +1981,21 @@ function createMcpServer(root = DEFAULT_ROOT, todos, contributions = []) {
 		const api = (todos.apiUrl ?? "https://api.github.com").replace(/\/$/, "");
 		server.registerTool("list_todos", {
 			title: "List open todos",
-			description: "List the OPEN model-anchored todos of this content repo — work items filed from the live model into the repo's issue tracker (label 'todo'). Each row carries the tracker id and URL, title, assignees, createdAt and the parsed anchor (process, model file, anchored BPMN elements). Optional filter on one process. Use for 'what is open on process X' or to cross-check a model answer against known open discrepancies.",
-			inputSchema: z.object({ process: z.string().optional().describe("Only todos anchored to this process id, e.g. order-to-cash") }),
+			description: "List the OPEN model-anchored todos of this content repo — work items filed from the live model into the repo's issue tracker (label 'todo'). Each row carries the tracker id and URL, title, assignees, createdAt and the parsed anchor (notation, model id, model file, anchored elements). Optional filter on one model: `id` (and `notation` for a stem shared across notations; without it a process wins). Use for 'what is open on process X' or to cross-check a model answer against known open discrepancies.",
+			inputSchema: z.object({
+				id: z.string().optional().describe("Only todos of this model id (any notation, from list_models)"),
+				notation: z.string().optional().describe("registry notation id — disambiguates a stem shared across notations")
+			}),
 			annotations: {
 				readOnlyHint: true,
 				openWorldHint: true
 			}
-		}, safe(async ({ process: processId }) => {
-			const res = await fetch(`${api}/repos/${todosRepo}/issues?state=open&labels=${encodeURIComponent(todoLabelQuery(processId))}&per_page=100`, { headers: {
+		}, safe(async ({ id, notation }) => {
+			const model = id ? {
+				notation: notation ?? (await findModel(id))?.notation ?? "bpmn",
+				id
+			} : void 0;
+			const res = await fetch(`${api}/repos/${todosRepo}/issues?state=open&labels=${encodeURIComponent(todoLabelQuery(model))}&per_page=100`, { headers: {
 				accept: "application/vnd.github+json",
 				authorization: `Bearer ${todosToken}`,
 				"user-agent": "designiq-mcp"
@@ -1929,7 +2009,10 @@ function createMcpServer(root = DEFAULT_ROOT, todos, contributions = []) {
 				assignees: (row.assignees ?? []).map((a) => a.login),
 				createdAt: row.created_at
 			}));
-			if (todos.length === 0) return ok(`No open todos${processId ? ` for process '${processId}'` : ""} in ${todosRepo}.`);
+			if (todos.length === 0) {
+				const of = model ? ` for ${model.notation === "bpmn" ? "process" : model.notation} '${model.id}'` : "";
+				return ok(`No open todos${of} in ${todosRepo}.`);
+			}
 			return ok(todos);
 		}));
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miragon/design-iq-mcp",
-  "version": "5.9.0",
+  "version": "5.11.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",