enterprise-architect-mcp 2.3.0 → 2.4.0

package/README.md

@@ -184,8 +184,8 @@ hand; answering the prompt once is what makes that unnecessary.
 | `ea_search` | Full-text search across elements, attributes, operations, and constraints. Case- and diacritic-insensitive across European Latin alphabets, decodes entity-encoded text. Each result carries the evidence for its match — the field, the attribute or operation it came from, and a snippet of the author's own text. Accepts a `packageScope` (package id or name) to restrict results to a package and its descendants, and reports a package breakdown axis when unscoped. |
 | `ea_get_element` | Full element detail — attributes, operations, diagrams it appears on, constraints (pre/post/invariant/process). Flags whether attribute multiplicity is contrastive. |
 | `ea_list_elements` | List elements in a package, optionally filtered by type. Windowed: reports the total and pages with `offset`. |
-| `ea_get_connectors` | Relationships for an element — includes feature-link resolution (which attribute/operation each end attaches to). |
-| `ea_get_diagram_elements` | Elements and connectors on a diagram, including implied connectors and feature links. |
+| `ea_get_connectors` | Relationships for an element — includes feature-link resolution (which attribute/operation each end attaches to). `Generalization` connectors carry a `role` (`child`/`parent`) on each end; filter `connectorType: "Generalization"` with `direction: "incoming"`/`"outgoing"` to list an element's direct children/parent(s) without a diagram. |
+| `ea_get_diagram_elements` | Elements and connectors on a diagram, including implied connectors and feature links. `elements` includes free-text `Note` diagram objects, which often carry a legend or abbreviation definitions. |
 | `ea_get_scenarios` | Use case scenario steps with all attributes (trigger, uses, result, link, state) and scenario notes. A step's `uses` may name a business rule or constraint by code — that code isn't independently searchable, it's retrieved via `ea_get_element` on the same element. |
 | `ea_get_package_tree` | Navigate the package hierarchy with recursive depth. |
 | `ea_list_diagrams` | Search diagrams by name, type and package. Windowed like the tools above. |

package/dist/tools/connectors.js

@@ -46,7 +46,7 @@ function parseFeatureLinks(db, styleEx) {
     return { sourceFeature, targetFeature };
 }
 export function configureConnectorTools(server, model) {
-    server.tool("ea_get_connectors", "Get all relationships (connectors) for a given element. `connectors` lists what the element is connected to and how (Realisation, Dependency, Association, etc.), each entry naming its `source` and `dest` ends. Feature links show which specific attribute or operation each end attaches to.", {
+    server.tool("ea_get_connectors", "Get all relationships (connectors) for a given element. `connectors` lists what the element is connected to and how (Realisation, Dependency, Association, etc.), each entry naming its `source` and `dest` ends. For Generalization connectors, `source` is always the specific (child) type and `dest` the general (parent) type \u2014 each end also carries a `role` making this explicit without needing to reason about direction. Filter by `connectorType` and `direction` to list an element's direct children (incoming Generalization) or direct parent(s) (outgoing Generalization) without a diagram. Feature links show which specific attribute or operation each end attaches to.", {
         elementId: z.coerce.number().describe("The Object_ID of the element to get connectors for"),
         connectorType: z
             .string()
@@ -113,8 +113,9 @@ export function configureConnectorTools(server, model) {
                     destCard: r.DestCard,
                     sourceRole: r.SourceRole || null,
                     destRole: r.DestRole || null,
-                    source: { id: r.Start_Object_ID, name: r.SourceName, type: r.SourceType, stereotype: r.SourceStereotype },
-                    dest: { id: r.End_Object_ID, name: r.DestName, type: r.DestType, stereotype: r.DestStereotype },
+                    // Generalization: Start_Object_ID is always the specific (child) type, End_Object_ID the general (parent) type.
+                    source: { id: r.Start_Object_ID, name: r.SourceName, type: r.SourceType, stereotype: r.SourceStereotype, ...(r.Connector_Type === "Generalization" ? { role: "child" } : {}) },
+                    dest: { id: r.End_Object_ID, name: r.DestName, type: r.DestType, stereotype: r.DestStereotype, ...(r.Connector_Type === "Generalization" ? { role: "parent" } : {}) },
                     sourceFeature,
                     targetFeature,
                 };

package/dist/tools/diagrams.js

@@ -44,7 +44,7 @@ function parseFeatureLinks(db, styleEx) {
     return { sourceFeature, targetFeature };
 }
 export function configureDiagramTools(server, model) {
-    server.tool("ea_get_diagram_elements", "Get all elements and connectors placed on a specific diagram: the `diagram` itself, plus `elements` and `connectors`. Connectors include feature-link resolution showing which attribute or operation each end attaches to. The connector list is the union of explicit t_diagramlinks rows and implied connectors (both ends on the diagram).", {
+    server.tool("ea_get_diagram_elements", "Get all elements and connectors placed on a specific diagram: the `diagram` itself, plus `elements` and `connectors`. `elements` already includes free-text `Note` diagram objects, which often carry a legend or abbreviation definitions an agent would otherwise miss. Connectors include feature-link resolution showing which attribute or operation each end attaches to. The connector list is the union of explicit t_diagramlinks rows and implied connectors (both ends on the diagram).", {
         diagramId: z.coerce.number().describe("The Diagram_ID to get elements for"),
     }, READ_ONLY, async ({ diagramId }) => {
         const db = await model.database();

package/dist/tools/elements.js

@@ -39,7 +39,7 @@ export function configureElementTools(server, model) {
                 type: a.Type,
                 scope: a.Scope,
                 stereotype: a.Stereotype,
-                notes: a.Notes,
+                notes: decodeEntities(a.Notes),
                 multiplicity: formatMultiplicity(a),
                 default: a.Default,
             }));
@@ -66,12 +66,12 @@ export function configureElementTools(server, model) {
                     returnType: op.Type,
                     scope: op.Scope,
                     stereotype: op.Stereotype,
-                    notes: op.Notes,
+                    notes: decodeEntities(op.Notes),
                     parameters: params.map((p) => ({
                         name: p.Name,
                         type: p.Type,
                         kind: p.Kind,
-                        notes: p.Notes,
+                        notes: decodeEntities(p.Notes),
                     })),
                 };
             });

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const packageVersion = "2.3.0+gf6910be";
+export declare const packageVersion = "2.4.0+g5d08fcc";

package/dist/version.js

@@ -1 +1 @@
-export const packageVersion = "2.3.0+gf6910be";
+export const packageVersion = "2.4.0+g5d08fcc";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "enterprise-architect-mcp",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "mcpName": "io.github.mm6502/enterprise-architect-mcp",
   "description": "MCP server for read-only access to Sparx Enterprise Architect .qea exports — search elements, navigate packages, read use case scenarios and traverse connectors from an AI agent",
   "keywords": [