fmea-api-mcp-server 1.1.37 → 1.1.39

package/dist/index.js

@@ -28,7 +28,7 @@ class ApiDocsServer {
     constructor() {
         this.server = new Server({
             name: "api-docs-mcp",
-            version: "1.1.37",
+            version: "1.1.39",
         }, {
             capabilities: {
                 resources: {},

package/dist/services/search/OramaSearchService.js

@@ -469,6 +469,10 @@ export class OramaSearchService {
         if (resource === 'system-definition' && (action === 'export' || action === 'import' || lower.includes('excel'))) {
             resource = 'system-definition-excel';
         }
+        // [R34] "synonym" + export/import/excel → prefer 'synonym-excel'
+        if (resource === 'synonym' && (action === 'export' || action === 'import' || lower.includes('excel'))) {
+            resource = 'synonym-excel';
+        }
         // [R19] "get X by Y ID" is a specific read, not a list
         if (action === 'list' && /\bby\b.*\bid\b/i.test(lower)) {
             action = 'read';

package/dist/synonyms.js

@@ -11,7 +11,8 @@ export const METHOD_ACTIONS = {
 export const RESOURCE_ALIASES = {
     // Core Entities
     // Core Entities
-    'division': ['organization', 'org', 'department', 'group', 'sector', 'unit'],
+    'division': ['organization', 'org', 'department', 'group', 'sector', 'unit', 'authorized division'], // [R34] Added authorized division alias
+    'authorized-division': ['authorized division', 'division permission', 'division access', 'access permission', 'authorized divisions'], // [R34] New authorized divisions resource
     'knowledge': ['knowledge', 'knowledge base'], // [R17] New Resource Support
     'document-category': ['category', 'document category', 'doc category', 'file category'], // [R22] Document category filtering
     'project': ['workspace', 'repo', 'application', 'app'], // [R13] Removed 'system' to avoid conflict
@@ -38,7 +39,9 @@ export const RESOURCE_ALIASES = {
     'excel': ['excel', 'spreadsheet', 'csv'], // [R16]
     'worksheet-excel': ['worksheet excel', 'excel worksheet', 'worksheet export', 'worksheet download'], // Worksheet Excel import/export
     'block-diagrams-excel': ['block diagram export', 'block excel', 'diagram export', 'export block', 'export diagram', 'export'], // [R22] Block Diagram Excel export
-    'synonym': ['synonyms', 'synonym'], // [Fix] Key must match singular resourceType for boosting
+    'synonym': ['synonyms', 'synonym', 'synonym group', 'synonym dictionary', 'term group'], // [R34] Enhanced synonym aliases
+    'synonym-excel': ['synonym excel', 'synonym export', 'synonym import', 'synonym spreadsheet'], // [R34] Synonym Excel import/export
+    'system-settings': ['system settings', 'system config', 'system configuration', 'global settings'], // [R34] System settings resource
     'recommendation-item': ['recommendation item', 'recommended action', 'corrective action', 'action item', 'mitigation item'], // [R20] New v2 recommendation items
     'fourm': ['4m', 'four m', '4m analysis', 'man machine material environment'], // 4M Analysis
     'term': ['term', 'terms', 'taxonomy', 'terminology', 'glossary'], // Term tree management — removed 'classification' (now dedicated resource [R28])
@@ -109,6 +112,8 @@ export const SYNONYM_GROUPS = {
     // Domain Specific (New)
     "organization": ["division", "department", "group", "team", "unit"],
     "division": ["organization", "department", "group", "section", "sector"],
+    "permission": ["access", "authorization", "authority", "privilege", "right"], // [R34]
+    "authorized": ["permitted", "allowed", "approved", "access control"], // [R34]
     "overview": ["summary", "description", "details", "info", "profile", "dashboard"],
     "dashboard": ["overview", "summary", "stats", "metrics", "report", "my projects", "action items", "rpn"], // [R25]
     "globally": ["global", "cross-project", "all projects", "system-wide"], // [R25]

package/endpoints/v2/block-diagrams/core.json

@@ -29,6 +29,15 @@
           "schema": {
             "type": "string"
           }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
         }
       ],
       "requestBody": null,
@@ -112,6 +121,15 @@
           "schema": {
             "type": "string"
           }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
         }
       ],
       "requestBody": null,
@@ -336,6 +354,15 @@
           "schema": {
             "type": "string"
           }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
         }
       ],
       "requestBody": null,
@@ -598,7 +625,7 @@
       "method": "GET",
       "operationId": "get",
       "summary": "Get failure mode details",
-      "description": "Returns a failure mode by ID. If search is provided, resolves by failure mode name within the block diagram.",
+      "description": "Returns a failure mode by ID.",
       "tags": [
         "Failure Mode"
       ],
@@ -629,14 +656,6 @@
           "schema": {
             "type": "string"
           }
-        },
-        {
-          "name": "q",
-          "in": "query",
-          "description": "Failure mode name keyword",
-          "schema": {
-            "type": "string"
-          }
         }
       ],
       "requestBody": null,
@@ -795,13 +814,13 @@
       }
     },
     {
-      "path": "/api/v2/projects/{projectId}/block-diagrams/{blockId}/nodes/{nodeId}/failure-modes",
+      "path": "/api/v2/projects/{projectId}/block-diagrams/{blockDiagramId}/failure-modes",
       "method": "GET",
-      "operationId": "listNodeFailureModes",
-      "summary": "List node failure modes",
-      "description": "Returns failure modes mapped to the target node. Optional search applies keyword filtering.",
+      "operationId": "list_6",
+      "summary": "List block diagram failure modes",
+      "description": "Returns failure modes visible in the target block diagram. Optional search applies keyword filtering.",
       "tags": [
-        "Block Diagram"
+        "Failure Mode"
       ],
       "parameters": [
         {
@@ -814,7 +833,7 @@
           }
         },
         {
-          "name": "blockId",
+          "name": "blockDiagramId",
           "in": "path",
           "description": "Block diagram ID",
           "required": true,
@@ -823,20 +842,20 @@
           }
         },
         {
-          "name": "nodeId",
-          "in": "path",
-          "description": "Block node ID",
-          "required": true,
+          "name": "q",
+          "in": "query",
+          "description": "Failure mode keyword search (trimmed, max 100 characters)",
           "schema": {
             "type": "string"
           }
         },
         {
-          "name": "q",
+          "name": "useSynonym",
           "in": "query",
-          "description": "Failure mode keyword search (trimmed, max 100 characters)",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
           "schema": {
-            "type": "string"
+            "type": "boolean",
+            "default": true
           }
         }
       ],
@@ -845,46 +864,7 @@
         "default": {
           "description": "default response",
           "content": {
-            "application/json": {
-              "schema": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "blockNodeId": {
-                      "type": "string"
-                    },
-                    "referencedBlockNodeId": {
-                      "type": "string"
-                    },
-                    "id": {
-                      "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    },
-                    "fmmDiagramType": {
-                      "type": "string",
-                      "enum": [
-                        "UNUSED",
-                        "NOT_SELECTED",
-                        "TYPE_A",
-                        "TYPE_C"
-                      ]
-                    },
-                    "rank": {
-                      "type": "string"
-                    },
-                    "complete": {
-                      "type": "string"
-                    },
-                    "transferFmmObject": {
-                      "type": "integer"
-                    }
-                  }
-                }
-              }
-            }
+            "application/json": {}
           }
         }
       }

package/endpoints/v2/condition-library/core.json

@@ -333,6 +333,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "page",
           "in": "query",
@@ -448,6 +457,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "page",
           "in": "query",

package/endpoints/v2/divisions/core.json

@@ -7,7 +7,7 @@
       "path": "/api/v2/divisions",
       "method": "GET",
       "summary": "Search divisions",
-      "operationId": "list_6",
+      "operationId": "list_7",
       "description": "Returns paged divisions filtered by division name.",
       "tags": [
         "Division"
@@ -21,6 +21,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "page",
           "in": "query",
@@ -151,6 +160,363 @@
           }
         }
       }
+    },
+    {
+      "path": "/api/v2/divisions/{divisionId}",
+      "method": "DELETE",
+      "operationId": "delete_2",
+      "summary": "Delete a division",
+      "description": "Deletes a division and its access list entries. Resets user mappings for divisions that referenced the deleted one. Fails if users are assigned to the division.",
+      "tags": [
+        "Division"
+      ],
+      "parameters": [
+        {
+          "name": "divisionId",
+          "in": "path",
+          "description": "Division ID to delete",
+          "required": true,
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/divisions/{divisionId}/authorized-divisions",
+      "method": "GET",
+      "operationId": "getAuthorizedDivisions",
+      "summary": "Get authorized divisions",
+      "description": "Returns the list of divisions that the specified division is authorized to access.",
+      "tags": [
+        "Division"
+      ],
+      "parameters": [
+        {
+          "name": "divisionId",
+          "in": "path",
+          "description": "Division ID to query authorized divisions for",
+          "required": true,
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer"
+                    },
+                    "no": {
+                      "type": "integer"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "relatedDivisions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "description": "(circular: DivisionDTO)"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/divisions",
+      "method": "POST",
+      "operationId": "create_3",
+      "summary": "Create a division",
+      "description": "Creates a new division with optional aliases and code. Automatically assigns global-access users to the new division.",
+      "tags": [
+        "Division"
+      ],
+      "parameters": [],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "aliases": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "code": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "integer"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "aliases": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "code": {
+                    "type": "string"
+                  },
+                  "relatedDivisions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "integer"
+                        },
+                        "no": {
+                          "type": "integer"
+                        },
+                        "name": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        },
+                        "relatedDivisions": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "description": "(circular: DivisionDTO)"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/divisions/{divisionId}",
+      "method": "PUT",
+      "operationId": "update_2",
+      "summary": "Update a division",
+      "description": "Updates division name, aliases, and code. Cascades code changes to associated projects.",
+      "tags": [
+        "Division"
+      ],
+      "parameters": [
+        {
+          "name": "divisionId",
+          "in": "path",
+          "description": "Division ID to update",
+          "required": true,
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "aliases": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "code": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "integer"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "aliases": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "code": {
+                    "type": "string"
+                  },
+                  "relatedDivisions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "integer"
+                        },
+                        "no": {
+                          "type": "integer"
+                        },
+                        "name": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": "string"
+                        },
+                        "relatedDivisions": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "description": "(circular: DivisionDTO)"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/divisions/{divisionId}/authorized-divisions",
+      "method": "PUT",
+      "operationId": "updateAuthorizedDivisions",
+      "summary": "Update authorized divisions",
+      "description": "Replaces the authorized division list for the specified division. Self-division ID is automatically excluded. User-division mappings are rebuilt after update.",
+      "tags": [
+        "Division"
+      ],
+      "parameters": [
+        {
+          "name": "divisionId",
+          "in": "path",
+          "description": "Division ID to update authorized divisions for",
+          "required": true,
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "authorizedDivisionIds": {
+                  "type": "array",
+                  "items": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer"
+                    },
+                    "no": {
+                      "type": "integer"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "relatedDivisions": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "description": "(circular: DivisionDTO)"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

package/endpoints/v2/documents/core.json

@@ -191,7 +191,7 @@
     {
       "path": "/api/v2/projects/{projectId}/documents/{documentId}",
       "method": "GET",
-      "operationId": "get_7",
+      "operationId": "get_8",
       "summary": "Get document by ID",
       "description": "Fetches detailed information for a specific document using its unique identifier (Retrieve / Fetch / View document details). Use this endpoint to obtain complete document metadata including name, category, path, creation timestamp, and associated file information. This is essential when you need to display document details, verify document existence, or access specific document properties before performing further operations like download or deletion.",
       "tags": [],
@@ -264,7 +264,7 @@
     {
       "path": "/api/v2/projects/{projectId}/documents/{documentId}",
       "method": "DELETE",
-      "operationId": "delete_6",
+      "operationId": "delete_8",
       "summary": "Delete document",
       "description": "Permanently removes a document from the project using its unique identifier (Remove / Erase document). This operation deletes the document record and disassociates it from the project. Use with caution as this action cannot be undone. Requires project member role with NORMAL user level permissions. Ensure you have the correct document ID before initiating deletion to avoid accidental data loss.",
       "tags": [],
@@ -348,7 +348,7 @@
     {
       "path": "/api/v2/projects/{projectId}/documents",
       "method": "GET",
-      "operationId": "list_12",
+      "operationId": "list_14",
       "summary": "List all Documents",
       "description": "Retrieves a comprehensive list of all documents associated with a specific project (Get all files / Fetch project documents / Query document library). Use this endpoint when you need to view, browse, or display the complete collection of documents within a project, including all categories and types. The response includes document metadata such as names, categories, paths, and timestamps, enabling users to navigate and manage the project document repository effectively.",
       "tags": [],