fmea-api-mcp-server 1.1.50 → 1.1.52

package/dist/index.js

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

package/dist/services/search/OramaSearchService.js

@@ -453,8 +453,12 @@ export class OramaSearchService {
             resource = potentialResources[0].type;
         }
         // [Heuristic] Compound resource detection:
+        // "worksheet" + "template" + "excel" → prefer 'worksheet-template-excel' [R40]
+        if (lower.includes('worksheet') && lower.includes('template') && lower.includes('excel')) {
+            resource = 'worksheet-template-excel';
+        }
         // "worksheet" + "excel" → prefer 'worksheet-excel' over either alone
-        if (lower.includes('worksheet') && lower.includes('excel')) {
+        else if (lower.includes('worksheet') && lower.includes('excel')) {
             resource = 'worksheet-excel';
         }
         // [R19] "failure mode" + "diagram" (without "block") → prefer fmm-diagram
@@ -473,6 +477,29 @@ export class OramaSearchService {
         if (resource === 'synonym' && (action === 'export' || action === 'import' || lower.includes('excel'))) {
             resource = 'synonym-excel';
         }
+        // [R40] Resource + export/excel/xlsx/spreadsheet → prefer dedicated '-excel' resource type
+        // Note: 'import' excluded to avoid false triggers (e.g. upload image → classification-excel)
+        const excelResources = [
+            'additional-info', 'api-key', 'apikey-log', 'classification',
+            'division', 'evaluation', 'notice', 'process-symbol', 'user', 'worksheet-template',
+        ];
+        const hasExcelSignal = action === 'export' || lower.includes('excel') || lower.includes('xlsx') || lower.includes('spreadsheet');
+        if (hasExcelSignal) {
+            for (const base of excelResources) {
+                if (resource === base) {
+                    resource = `${base}-excel`;
+                    break;
+                }
+            }
+            // significance-criteria + excel signal → evaluation-excel
+            if (resource === 'significance-criteria') {
+                resource = 'evaluation-excel';
+            }
+        }
+        // [R40] 'revision' resource is always a MONITOR operation (change/edit history)
+        if (resource === 'revision') {
+            action = 'MONITOR';
+        }
         // [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

@@ -31,12 +31,12 @@ export const RESOURCE_ALIASES = {
     'user': ['person', 'account', 'profile'], // Removed 'member' from here to avoid conflict
     'member': ['member', 'project member', 'team'], // [R13] Distinct resource type matching indexer
     'document': ['file', 'attachment', 'upload', 'paperwork', 'files'], // [R13] Added plural 'files'
-    'api-key': ['key', 'secret', 'credential', 'authenticate', 'client auth', 'client credential'], // [R15] [R22] Added authenticate/client for API key auth
+    'api-key': ['key', 'secret', 'credential', 'authenticate', 'client auth', 'client credential', 'api key'], // [R15] [R22] [R40] Added 'api key' for explicit phrase match
     'worksheet-template': ['template', 'sheet structure', 'configuration'], // [R18] [R26] Added 'configuration' for template setup queries
     'action-status-template': ['status template', 'action status'], // [R15]
     'join-request': ['join', 'invite', 'add user', 'member request', 'pending', 'join request'], // [R16]
     'fmm-diagram': ['fmm', 'fmm diagram', 'failure mode diagram', 'causal diagram'], // [R19] Dedicated FMM diagram resource
-    'excel': ['excel', 'spreadsheet', 'csv'], // [R16]
+    'excel': ['excel', 'csv'], // [R16] Removed 'spreadsheet' — it's a trigger for resource-specific excel export heuristics
     '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', 'synonym group', 'synonym dictionary', 'term group'], // [R34] Enhanced synonym aliases
@@ -63,6 +63,19 @@ export const RESOURCE_ALIASES = {
     'board': ['board comment', 'board discussion', 'discussion board', 'comment thread', 'review comment', 'discussion', 'comment board'], // [R39] Board comments/discussion
     'notice': ['notice', 'notices', 'announcement', 'bulletin', 'notification'], // [R32] Notice CRUD and visibility
     'tree-search': ['tree search', 'tree query', 'structure search', 'pattern search', 'subtree match', 'anchor pattern', 'context completion', 'reference node', 'rebuild index', 'reindex'], // [R35] Tree search query and index rebuild
+    // [R40] New Excel export endpoints
+    'additional-info-excel': ['additional info excel', 'additional information excel', 'export additional info', 'additional info export', 'additional fields spreadsheet'],
+    'api-key-excel': ['api key excel', 'api keys excel', 'export api keys', 'api key export', 'keys spreadsheet'],
+    'apikey-log-excel': ['api key log excel', 'api key audit excel', 'export api key logs', 'api key audit export', 'key log spreadsheet', 'api key audit', 'api key log', 'api key usage log', 'apikey audit log'],
+    'classification-excel': ['classification excel', 'export classification', 'classification export', 'classification groups excel'],
+    'division-excel': ['division excel', 'export divisions', 'divisions excel', 'division export', 'divisions spreadsheet'],
+    'evaluation-excel': ['evaluation excel', 'evaluation export', 'export evaluation', 'criteria excel', 'evaluation criteria excel'],
+    'notice-excel': ['notice excel', 'notices excel', 'export notices', 'notice export', 'announcements excel'],
+    'process-symbol-excel': ['process symbol excel', 'process symbols excel', 'export process symbols', 'process symbol export'],
+    'user-excel': ['user excel', 'users excel', 'export users', 'user list excel', 'users spreadsheet', 'user list spreadsheet'],
+    'worksheet-template-excel': ['worksheet template excel', 'template excel', 'export worksheet templates', 'worksheet templates spreadsheet'],
+    // [R40] Revision history
+    'revision': ['revision history', 'change history', 'change log', 'edit history', 'project history', 'version history', 'audit history', 'revisions'],
 };
 export const SYNONYM_GROUPS = {
     // Read / Retrieve
@@ -86,6 +99,8 @@ export const SYNONYM_GROUPS = {
     // Delete
     "delete": ["remove", "destroy", "clear", "erase", "drop", "cancel", "archive", "unlink"],
     "remove": ["delete", "detach", "discard", "exclude", "strip"],
+    "bulk": ["batch", "multiple", "mass", "many", "group", "several"], // [R40] bulk → batch for batch-delete endpoints
+    "several": ["multiple", "batch", "bulk", "many", "group"], // [R40] several → batch
     // Processing / Execution (New)
     "parse": ["parsing", "read", "decode", "interpret", "analyze", "extract", "scan"],
     "parsing": ["parse", "reading", "decoding", "interpreting", "analyzing"],

package/endpoints/v2/additional-info/core.json

@@ -111,7 +111,7 @@
       "method": "GET",
       "operationId": "getAttributesByFmeaType",
       "summary": "List attributes by FMEA type",
-      "description": "Returns all additional information attributes (with items) for the given FMEA type.",
+      "description": "Returns all additional information attributes (with items) for the given FMEA type. Supports optional keyword search on attribute label or item label.",
       "tags": [
         "Additional Info Template"
       ],
@@ -131,6 +131,14 @@
               "CPLAN"
             ]
           }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword filter applied to attribute label or item label (max 100 chars)",
+          "schema": {
+            "type": "string"
+          }
         }
       ],
       "requestBody": null,
@@ -140,73 +148,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "integer"
-                    },
-                    "fmeaType": {
-                      "type": "string",
-                      "enum": [
-                        "DESIGN",
-                        "PROCESS",
-                        "EQUIPMENT",
-                        "FA",
-                        "FTA",
-                        "CPLAN"
-                      ]
-                    },
-                    "label": {
-                      "type": "string"
-                    },
-                    "typeId": {
-                      "type": "integer"
-                    },
-                    "type": {
-                      "type": "string",
-                      "enum": [
-                        "TEXT",
-                        "DATE",
-                        "SELECT",
-                        "LIST"
-                      ]
-                    },
-                    "typeAlias": {
-                      "type": "string"
-                    },
-                    "displayOrder": {
-                      "type": "integer"
-                    },
-                    "options": {
-                      "type": "object"
-                    },
-                    "items": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "id": {
-                            "type": "integer"
-                          },
-                          "label": {
-                            "type": "string"
-                          },
-                          "itemType": {
-                            "type": "string"
-                          },
-                          "displayOrder": {
-                            "type": "integer"
-                          },
-                          "options": {
-                            "type": "object"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
+                "type": "object"
               }
             }
           }
@@ -316,7 +258,7 @@
       "method": "GET",
       "operationId": "getFieldsByFmeaType",
       "summary": "List fields by FMEA type",
-      "description": "Returns all additional information fields for the given FMEA type.",
+      "description": "Returns all additional information fields for the given FMEA type. Supports optional keyword search on field label.",
       "tags": [
         "Additional Info Template"
       ],
@@ -336,6 +278,14 @@
               "CPLAN"
             ]
           }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword filter applied to field label (max 100 chars)",
+          "schema": {
+            "type": "string"
+          }
         }
       ],
       "requestBody": null,
@@ -345,76 +295,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "integer"
-                    },
-                    "fmeaType": {
-                      "type": "string",
-                      "enum": [
-                        "DESIGN",
-                        "PROCESS",
-                        "EQUIPMENT",
-                        "FA",
-                        "FTA",
-                        "CPLAN"
-                      ]
-                    },
-                    "label": {
-                      "type": "string"
-                    },
-                    "typeId": {
-                      "type": "integer"
-                    },
-                    "type": {
-                      "type": "string",
-                      "enum": [
-                        "TEXT",
-                        "DATE",
-                        "SELECT",
-                        "LIST"
-                      ]
-                    },
-                    "typeAlias": {
-                      "type": "string"
-                    },
-                    "displayOrder": {
-                      "type": "integer"
-                    },
-                    "attributeId": {
-                      "type": "integer"
-                    },
-                    "attributeLabel": {
-                      "type": "string"
-                    },
-                    "options": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "fieldId": {
-                            "type": "integer"
-                          },
-                          "name": {
-                            "type": "string"
-                          },
-                          "value": {
-                            "type": "string"
-                          },
-                          "attributeId": {
-                            "type": "integer"
-                          },
-                          "itemId": {
-                            "type": "integer"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
+                "type": "object"
               }
             }
           }

package/endpoints/v2/additional-info-excel/core.json

@@ -0,0 +1,48 @@
+{
+  "category": "Additional Info Excel",
+  "version": "v2",
+  "description": "",
+  "endpoints": [
+    {
+      "path": "/api/v2/additional-info-excel/export",
+      "method": "GET",
+      "operationId": "export",
+      "summary": "Export additional info fields to Excel",
+      "description": "Exports additional information fields to an XLSX file and returns a download URI. Supports optional FMEA type filter and keyword search on field label. Requires admin permission.",
+      "tags": [
+        "AdditionalInfoExcel"
+      ],
+      "parameters": [
+        {
+          "name": "fmeaType",
+          "in": "query",
+          "description": "FMEA type filter (e.g. stress|design|process). Required.",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword filter for exported rows (max 100 chars)",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/endpoints/v2/api-key-excel/core.json

@@ -0,0 +1,72 @@
+{
+  "category": "Api Key Excel",
+  "version": "v2",
+  "description": "",
+  "endpoints": [
+    {
+      "path": "/api/v2/admin/api-key-excel/export",
+      "method": "GET",
+      "operationId": "export_1",
+      "summary": "Export all API keys to Excel",
+      "description": "Exports all API keys to an XLSX file and returns a download URI. Supports filtering by user ID, active status, expiry state, and keyword search. Only accessible via session (JWT) authentication; API key auth is rejected. Requires admin permission.",
+      "tags": [
+        "Admin - API Key Excel"
+      ],
+      "parameters": [
+        {
+          "name": "userid",
+          "in": "query",
+          "description": "Filter by user ID (optional, exact match)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "isActive",
+          "in": "query",
+          "description": "Filter by active status: true=active only, false=inactive only",
+          "schema": {
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "expiredOnly",
+          "in": "query",
+          "description": "If true, return only expired keys",
+          "schema": {
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword search on key name or key prefix (max 100 characters)",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "fileName": {
+                    "type": "string"
+                  },
+                  "downloadUri": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/endpoints/v2/api-keys/core.json

@@ -172,6 +172,14 @@
             "default": 20,
             "format": "int32"
           }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword search on key name or key prefix (max 100 characters)",
+          "schema": {
+            "type": "string"
+          }
         }
       ],
       "responses": {
@@ -323,6 +331,14 @@
             "default": 20,
             "format": "int32"
           }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword search on reason field (max 100 characters)",
+          "schema": {
+            "type": "string"
+          }
         }
       ],
       "responses": {

package/endpoints/v2/apikey-log-excel/core.json

@@ -0,0 +1,88 @@
+{
+  "category": "Apikey Log Excel",
+  "version": "v2",
+  "description": "",
+  "endpoints": [
+    {
+      "path": "/api/v2/admin/apikey-log-excel/export",
+      "method": "GET",
+      "operationId": "export_2",
+      "summary": "Export API key audit logs to Excel",
+      "description": "Exports API key admin audit logs to an XLSX file and returns a download URI. Supports filtering by admin user ID, target user ID, action type, date range, and keyword search. Only accessible via session (JWT) authentication; API key auth is rejected. Requires admin permission.",
+      "tags": [
+        "Admin - API Key Log Excel"
+      ],
+      "parameters": [
+        {
+          "name": "adminUserid",
+          "in": "query",
+          "description": "Filter by the admin who performed the action (optional, exact match)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "targetUserid",
+          "in": "query",
+          "description": "Filter by the user whose key was affected (optional, exact match)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "action",
+          "in": "query",
+          "description": "Filter by action type (e.g. CREATE, DEACTIVATE, BULK_DEACTIVATE)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "startDate",
+          "in": "query",
+          "description": "Start date for the log query range (YYYYMMDD, inclusive)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "endDate",
+          "in": "query",
+          "description": "End date for the log query range (YYYYMMDD, inclusive)",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword search on admin user ID or target user ID (max 100 characters)",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "fileName": {
+                    "type": "string"
+                  },
+                  "downloadUri": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/endpoints/v2/classification-excel/core.json

@@ -0,0 +1,40 @@
+{
+  "category": "Classification Excel",
+  "version": "v2",
+  "description": "",
+  "endpoints": [
+    {
+      "path": "/api/v2/classification-excel/export",
+      "method": "GET",
+      "operationId": "export_3",
+      "summary": "Export classification groups and items to Excel",
+      "description": "Exports all classification groups and their items to an XLSX file and returns a download URI. Supports optional keyword search filter on group title or item title. Requires admin permission.",
+      "tags": [
+        "ClassificationExcel"
+      ],
+      "parameters": [
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword filter for exported rows (max 100 chars)",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/endpoints/v2/classifications/core.json

@@ -129,11 +129,20 @@
       "method": "GET",
       "operationId": "getAllGroups",
       "summary": "List all classification groups",
-      "description": "Returns all classification groups with their nested items. Each group contains items with symbol type (text or image) and optional image URL.",
+      "description": "Returns all classification groups with their nested items. Each group contains items with symbol type (text or image) and optional image URL. Supports optional keyword search on group title or item title.",
       "tags": [
         "Classification"
       ],
-      "parameters": [],
+      "parameters": [
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Keyword filter applied to group title or item title (max 100 chars)",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
       "requestBody": null,
       "responses": {
         "default": {

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

@@ -69,6 +69,40 @@
         }
       },
       "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file identifier returned by the upload endpoint."
+    },
+    {
+      "path": "/api/v2/condition-library-excel/export",
+      "method": "GET",
+      "operationId": "export_11",
+      "summary": "Export condition library to Excel",
+      "description": "Exports condition library of specified type to an XLSX file.",
+      "tags": [
+        "Condition Library Excel"
+      ],
+      "parameters": [
+        {
+          "name": "type",
+          "in": "query",
+          "description": "Condition library type (stress/design/process)",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }