fmea-api-mcp-server 1.1.37 → 1.1.38

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.38",
         }, {
             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

@@ -598,7 +598,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 +629,6 @@
           "schema": {
             "type": "string"
           }
-        },
-        {
-          "name": "q",
-          "in": "query",
-          "description": "Failure mode name keyword",
-          "schema": {
-            "type": "string"
-          }
         }
       ],
       "requestBody": null,
@@ -795,13 +787,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 +806,7 @@
           }
         },
         {
-          "name": "blockId",
+          "name": "blockDiagramId",
           "in": "path",
           "description": "Block diagram ID",
           "required": true,
@@ -822,15 +814,6 @@
             "type": "string"
           }
         },
-        {
-          "name": "nodeId",
-          "in": "path",
-          "description": "Block node ID",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        },
         {
           "name": "q",
           "in": "query",
@@ -845,46 +828,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/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"
@@ -151,6 +151,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": [],

package/endpoints/v2/failure-modes/core.json

@@ -8,7 +8,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"
       ],
@@ -39,14 +39,6 @@
           "schema": {
             "type": "string"
           }
-        },
-        {
-          "name": "q",
-          "in": "query",
-          "description": "Failure mode name keyword",
-          "schema": {
-            "type": "string"
-          }
         }
       ],
       "requestBody": null,

package/endpoints/v2/fourm/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "GET",
-      "operationId": "list_7",
+      "operationId": "list_8",
       "summary": "List 4M analysis items",
       "description": "Retrieves all 4M (Man, Machine, Material, Environment) analysis items with optional filtering. Supports querying by project ID (projectId) and single or double tags (tag, secondTag) for targeted searches. Use this endpoint to browse, filter, or search for existing 4M analysis records within a project context. Returns a comprehensive list of analysis entries that can be further processed or displayed.",
       "tags": [],
@@ -82,7 +82,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "POST",
-      "operationId": "create_3",
+      "operationId": "create_4",
       "summary": "Create 4M analysis item",
       "description": "Creates a new 4M (Man, Machine, Material, Environment) analysis item in the system. Accepts analysis data including categorization by the four M dimensions (Man/Personnel, Machine/Equipment, Material/Resources, Environment/Conditions). Use this endpoint to initiate a new 4M analysis, register factors for quality or risk assessment, or document production variables. Returns the complete created object with system-generated ID.",
       "tags": [],
@@ -228,7 +228,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "PUT",
-      "operationId": "update_2",
+      "operationId": "update_3",
       "summary": "Update 4M analysis item",
       "description": "Modifies an existing 4M analysis item identified by its ID. Accepts partial or complete updates to the analysis data including changes to categorization, descriptions, or any of the four M dimensions (Man, Machine, Material, Environment). Use this endpoint to correct, enhance, or evolve analysis records over time. Returns the updated object reflecting all changes applied.",
       "tags": [],
@@ -314,7 +314,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "DELETE",
-      "operationId": "delete_2",
+      "operationId": "delete_3",
       "summary": "Delete 4M analysis item",
       "description": "Permanently removes a 4M analysis item from the system using its unique identifier. This operation is irreversible and will eliminate all associated data including the four M dimension classifications (Man, Machine, Material, Environment). Use with caution for removing obsolete or incorrect analysis records. Returns no content upon successful deletion (204 status).",
       "tags": [],

package/endpoints/v2/high-items/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/projects/{projectId}/high-items",
       "method": "PUT",
-      "operationId": "update_6",
+      "operationId": "update_8",
       "summary": "Batch upsert and reorder high items by project",
       "description": "Updates the project high-item list with batch upsert semantics. Existing items are matched by sequence or title, ranks are recalculated by input order, and omitted items are removed.",
       "tags": [

package/endpoints/v2/notices/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/notices/{id}",
       "method": "DELETE",
-      "operationId": "delete_3",
+      "operationId": "delete_4",
       "summary": "Delete notice",
       "description": "Deletes a notice by ID. Requires admin permission. Returns 404 if notice does not exist.",
       "tags": [
@@ -37,7 +37,7 @@
     {
       "path": "/api/v2/notices",
       "method": "GET",
-      "operationId": "list_8",
+      "operationId": "list_9",
       "summary": "List notices",
       "description": "Returns a paged list of notices. Supports optional visibility filter. Use page=0 to retrieve all notices without paging.",
       "tags": [
@@ -286,7 +286,7 @@
     {
       "path": "/api/v2/notices",
       "method": "POST",
-      "operationId": "create_4",
+      "operationId": "create_5",
       "summary": "Create notice",
       "description": "Creates a new notice. Requires admin permission. Title and content are required fields.",
       "tags": [
@@ -362,7 +362,7 @@
     {
       "path": "/api/v2/notices/{id}",
       "method": "PUT",
-      "operationId": "update_3",
+      "operationId": "update_4",
       "summary": "Update notice",
       "description": "Updates an existing notice by ID. Requires admin permission. Returns 404 if notice does not exist.",
       "tags": [