@eventcatalog/core 5.4.2 → 5.5.0

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,8 +1,8 @@
 import {
   raiseEvent
-} from "../chunk-EXRIIYEP.js";
+} from "../chunk-RDF2OMEF.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-HV4ONKTM.js";
+import "../chunk-WPFA7AGD.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -169,7 +169,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,12 +1,12 @@
 import {
   log_build_default
-} from "../chunk-VSBMYXLL.js";
+} from "../chunk-3TREOJOK.js";
 import "../chunk-AD7CL772.js";
-import "../chunk-EXRIIYEP.js";
+import "../chunk-RDF2OMEF.js";
 import "../chunk-YRZK7HKX.js";
 import "../chunk-CA6WCQ2T.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-HV4ONKTM.js";
+import "../chunk-WPFA7AGD.js";
 import "../chunk-4G7FSRPN.js";
 export {
   log_build_default as default

package/dist/{chunk-VSBMYXLL.js → chunk-3TREOJOK.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AD7CL772.js";
 import {
   raiseEvent
-} from "./chunk-EXRIIYEP.js";
+} from "./chunk-RDF2OMEF.js";
 import {
   countResources,
   hashCatalogContent,

package/dist/{chunk-CQ4L4SMB.js → chunk-754U4T7K.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-XB6FJMI3.js";
+} from "./chunk-UBDTKNFS.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-EXRIIYEP.js → chunk-RDF2OMEF.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CPW6G62V.js";
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-WPFA7AGD.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/{chunk-XB6FJMI3.js → chunk-UBDTKNFS.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-WPFA7AGD.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-HV4ONKTM.js → chunk-WPFA7AGD.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-WPFA7AGD.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

@@ -174,7 +174,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -1,18 +1,18 @@
+import {
+  stopChildWithParent
+} from "./chunk-S5GWAUG5.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
-import {
-  stopChildWithParent
-} from "./chunk-S5GWAUG5.js";
 import {
   log_build_default
-} from "./chunk-VSBMYXLL.js";
+} from "./chunk-3TREOJOK.js";
 import {
   getLicenseStatus,
   printLicenseStatus
 } from "./chunk-AD7CL772.js";
-import "./chunk-EXRIIYEP.js";
+import "./chunk-RDF2OMEF.js";
 import "./chunk-YRZK7HKX.js";
 import "./chunk-CA6WCQ2T.js";
 import "./chunk-CPW6G62V.js";
@@ -39,10 +39,10 @@ import {
 } from "./chunk-NKNOXQ62.js";
 import {
   generate
-} from "./chunk-CQ4L4SMB.js";
+} from "./chunk-754U4T7K.js";
 import {
   logger
-} from "./chunk-XB6FJMI3.js";
+} from "./chunk-UBDTKNFS.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-PD7KTSYN.js";
@@ -79,7 +79,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-WPFA7AGD.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

@@ -105,7 +105,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-CQ4L4SMB.js";
-import "./chunk-XB6FJMI3.js";
-import "./chunk-HV4ONKTM.js";
+} from "./chunk-754U4T7K.js";
+import "./chunk-UBDTKNFS.js";
+import "./chunk-WPFA7AGD.js";
 import "./chunk-4G7FSRPN.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-XB6FJMI3.js";
-import "../chunk-HV4ONKTM.js";
+} from "../chunk-UBDTKNFS.js";
+import "../chunk-WPFA7AGD.js";
 export {
   logger
 };

package/eventcatalog/src/components/MDX/NodeGraph/AstroNodeGraph.tsx

@@ -78,6 +78,8 @@ interface AstroNodeGraphProps {
   hiddenMessagesGraph?: { nodes: Node[]; edges: Edge[] };
   // The kind of diagram, so the level is remembered for each kind
   preferenceScope?: string;
+  // On the visualiser's own pages: keep the Mermaid view in the URL (`?render=mermaid`)
+  syncRenderModeWithUrl?: boolean;
   // Group a flow's steps into swimlanes to start with
   swimlanes?: FlowGroupBy;
   // The Studio API's address, when Studio is on: the menu can then start a canvas from the diagram

package/eventcatalog/src/components/MDX/NodeGraph/NodeGraph.astro

@@ -66,6 +66,9 @@ interface Props {
   overview?: { label: string };
   // Flows only: group the steps into swimlanes to start with
   lanes?: FlowGroupBy;
+  // The visualiser's own pages: keep the Mermaid view in the URL (`?render=mermaid`), so links open in it.
+  // Not docs pages, which can show several diagrams.
+  syncRenderModeWithUrl?: boolean;
 }
 
 const {
@@ -84,6 +87,7 @@ const {
   disableMessageAnimation,
   overview,
   lanes,
+  syncRenderModeWithUrl = false,
 } = Astro.props;
 
 let nodes = [],
@@ -263,6 +267,7 @@ if (overview && levelsOverview) {
     preferenceScope={collection}
     swimlanes={lanes}
     studioApiUrl={studioApiUrl}
+    syncRenderModeWithUrl={syncRenderModeWithUrl}
   />
 </div>
 

package/eventcatalog/src/features/ai/chat-api.ts

@@ -29,6 +29,7 @@ import {
   resourceCollectionSchema,
   messageCollectionSchema,
   visualiserCollectionSchema,
+  architectureDiagramDetailSchema,
   toolDescriptions,
 } from '@features/tools/catalog-tools';
 
@@ -136,7 +137,8 @@ The referer URL is: ${referrer}
 
 IMPORTANT: When the user is on a visualiser page (/visualiser/*) or asks about architecture, dependencies, data flow, or connections:
 - Use the getArchitectureDiagramAsMermaid tool to fetch the architecture diagram
-- The mermaid code shows all the connections between resources (services, events, channels, etc.)
+- The mermaid code shows all the connections between resources (services, events, channels, etc.), with domains and systems as subgraphs around what's in them
+- For a high-level answer about a domain or system, pass detail "overview" (domains, systems and their relationships) or "services" (services and data stores) instead of the full diagram
 - Use this to provide accurate, contextual answers about the architecture
 
 Sometimes the user will be on the specification page (openapi, asyncapi, graphql) for a resource too 
@@ -336,9 +338,10 @@ export const POST = async ({ request }: APIContext<{ question: string; messages:
               'The collection of the resource (events, commands, queries, services, domains, systems, flows, containers, data-products)'
             )
             .default('services'),
+          detail: architectureDiagramDetailSchema.optional(),
         }),
-        execute: async ({ resourceId, resourceVersion, resourceCollection }) => {
-          return await getArchitectureDiagramImpl({ resourceId, resourceVersion, resourceCollection });
+        execute: async ({ resourceId, resourceVersion, resourceCollection, detail }) => {
+          return await getArchitectureDiagramImpl({ resourceId, resourceVersion, resourceCollection, detail });
         },
       }),
       getCustomDocs: tool({

package/eventcatalog/src/features/mcp/apps/architecture-diagram/shared.ts

@@ -2,7 +2,7 @@
  * Shared by the MCP server and the architecture diagram MCP App view (view.tsx, shown by the viewer in ../viewer).
  * Kept free of server-only imports so it can be bundled into the view.
  */
-import type { ArchitectureDiagramView } from '@utils/node-graphs/architecture-diagram-types';
+import type { ArchitectureDiagramDetail, ArchitectureDiagramView } from '@utils/node-graphs/architecture-diagram-types';
 
 export type ArchitectureDiagramPayload = {
   resource: { collection: string; id: string; version: string; name: string };
@@ -11,4 +11,6 @@ export type ArchitectureDiagramPayload = {
   /** Path of the resource's Diagram page in EventCatalog */
   visualiserPath: string;
   view: ArchitectureDiagramView;
+  /** The level the diagram was asked for, to open at it (otherwise the diagram's own default) */
+  detail?: ArchitectureDiagramDetail;
 };

package/eventcatalog/src/features/mcp/apps/architecture-diagram/view.tsx

@@ -11,6 +11,9 @@ import visualiserStyles from '@eventcatalog/visualiser/styles.css?inline';
 import type { App, McpUiHostContext } from '@modelcontextprotocol/ext-apps';
 import type { Node } from '@xyflow/react';
 import type { ArchitectureDiagramPayload } from './shared';
+
+/** The diagram's level for each level of detail an MCP client can ask for */
+const LEVEL_OF_DETAIL = { overview: 1, services: 2, full: 3 } as const;
 import { NodeChat, describeNode, describeNodeForModel, type SelectedNode } from './node-chat';
 import { parseAskLink, parseDiagramLink, withAskMenuItem, type DiagramLink } from './links';
 import { getToolResultPayload } from '../shared/app-view';
@@ -421,7 +424,8 @@ export function ArchitectureDiagramView({ app, payload: toolPayload, hostContext
           />
         )}
       </div>
-      <div style={{ display: 'none' }} key={`${graphId}-graph`}>
+      {/* Again for another level of the same diagram, so it opens at it */}
+      <div style={{ display: 'none' }} key={`${graphId}-${payload.detail ?? 'default'}-graph`}>
         <NodeGraph
           id={graphId}
           nodes={graph.nodes}
@@ -436,6 +440,7 @@ export function ArchitectureDiagramView({ app, payload: toolPayload, hostContext
           }
           hiddenMessagesGraph={graph.hiddenMessages}
           preferenceScope={resource.collection}
+          initialLevel={payload.detail ? LEVEL_OF_DETAIL[payload.detail] : undefined}
           mode="full"
           linkTo="docs"
           showSearch