fmea-api-mcp-server 1.1.63 → 1.1.65

package/endpoints/v2/projects/core.json

@@ -380,6 +380,12 @@
                                 "code": {
                                   "type": "string"
                                 },
+                                "aliases": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
                                 "relatedDivisions": {
                                   "type": "array",
                                   "items": {
@@ -833,6 +839,12 @@
                             "code": {
                               "type": "string"
                             },
+                            "aliases": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
                             "relatedDivisions": {
                               "type": "array",
                               "items": {
@@ -929,6 +941,12 @@
                             "code": {
                               "type": "string"
                             },
+                            "aliases": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
                             "relatedDivisions": {
                               "type": "array",
                               "items": {
@@ -1400,6 +1418,12 @@
                                 "code": {
                                   "type": "string"
                                 },
+                                "aliases": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  }
+                                },
                                 "relatedDivisions": {
                                   "type": "array",
                                   "items": {
@@ -1944,7 +1968,7 @@
     {
       "path": "/api/v2/projects/groups/{groupId}",
       "method": "DELETE",
-      "operationId": "deleteGroup_1",
+      "operationId": "deleteGroup",
       "summary": "Delete project group",
       "description": "Deletes every stored row for an owned project group.",
       "tags": [
@@ -2087,7 +2111,7 @@
     {
       "path": "/api/v2/projects/groups",
       "method": "POST",
-      "operationId": "createGroup_1",
+      "operationId": "createGroup",
       "summary": "Create project group",
       "description": "Creates a new project group for the authenticated user. The server assigns the next sort order in the user's list and stores an empty-group placeholder row. Duplicate names are rejected within the authenticated user's scope.",
       "tags": [

package/endpoints/v2/scoring/core.json

@@ -3,36 +3,6 @@
   "version": "v2",
   "description": "",
   "endpoints": [
-    {
-      "path": "/api/v2/scoring/criteria/{id}",
-      "method": "DELETE",
-      "operationId": "deleteItem_3",
-      "summary": "Delete scoring criteria item",
-      "description": "Deletes a scoring criteria item and all its descendants recursively. Returns 404 if the item does not exist.",
-      "tags": [
-        "Scoring Criteria"
-      ],
-      "parameters": [
-        {
-          "name": "id",
-          "in": "path",
-          "description": "Unique ID of the scoring criteria item to delete",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        }
-      ],
-      "requestBody": null,
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {}
-          }
-        }
-      }
-    },
     {
       "path": "/api/v2/scoring/criteria/tree",
       "method": "GET",
@@ -90,9 +60,9 @@
     {
       "path": "/api/v2/scoring/criteria/{id}",
       "method": "GET",
-      "operationId": "getItem_1",
+      "operationId": "getItem",
       "summary": "Get scoring criteria item",
-      "description": "Returns a single scoring criteria item by ID. Returns 404 if the item does not exist.",
+      "description": "Helper read that returns a single scoring criteria item by ID. The main admin snapshot source read is GET /api/v2/scoring/criteria/tree. Returns 404 if the item does not exist.",
       "tags": [
         "Scoring Criteria"
       ],
@@ -155,7 +125,7 @@
       "method": "GET",
       "operationId": "getBreadcrumb",
       "summary": "Get breadcrumb path for scoring criteria item",
-      "description": "Returns the breadcrumb path from root to the specified item. Useful for navigation to show where an item sits in the hierarchy.",
+      "description": "Helper read that returns the breadcrumb path from root to the specified item. Useful for navigation to show where an item sits in the hierarchy. The main admin snapshot source read is GET /api/v2/scoring/criteria/tree.",
       "tags": [
         "Scoring Criteria"
       ],
@@ -221,7 +191,7 @@
       "method": "GET",
       "operationId": "getChildren",
       "summary": "Get children of scoring criteria item",
-      "description": "Returns the direct children of the specified scoring criteria item. Results are sorted by score descending.",
+      "description": "Helper read that returns the direct children of the specified scoring criteria item. Results are sorted by score descending. The main admin snapshot source read is GET /api/v2/scoring/criteria/tree.",
       "tags": [
         "Scoring Criteria"
       ],
@@ -283,123 +253,49 @@
       }
     },
     {
-      "path": "/api/v2/scoring/criteria/{parentId}/items",
-      "method": "POST",
-      "operationId": "createItem_3",
-      "summary": "Create scoring criteria item",
-      "description": "Creates a new scoring criteria item under the specified parent. The child type is auto-determined based on the parent type. Score validation applies for s_Scoring type (0-10).",
+      "path": "/api/v2/scoring/criteria/tree",
+      "method": "PUT",
+      "operationId": "saveTreeSnapshot",
+      "summary": "Save scoring criteria tree snapshot",
+      "description": "Saves the entire scoring criteria tree as one snapshot. The request is rooted at the scoring tree root and includes title, description, score, type, and ordered children. Omitted nodes are deleted with their subtrees, and sibling order is persisted by tree array position.",
       "tags": [
         "Scoring Criteria"
       ],
-      "parameters": [
-        {
-          "name": "parentId",
-          "in": "path",
-          "description": "ID of the parent scoring criteria item",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        }
-      ],
+      "parameters": [],
       "requestBody": {
         "content": {
           "application/json": {
             "schema": {
               "type": "object",
               "properties": {
-                "title": {
-                  "type": "string"
-                },
-                "description": {
+                "id": {
                   "type": "string"
                 },
-                "score": {
-                  "type": "integer",
-                  "format": "int32"
-                }
-              }
-            }
-          }
-        }
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "id": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  },
-                  "description": {
-                    "type": "string"
-                  },
-                  "type": {
-                    "type": "string",
-                    "enum": [
-                      "SCORING_TYPE",
-                      "S_PART",
-                      "S_SCORING",
-                      "S_VALUE"
-                    ]
-                  },
-                  "depth": {
-                    "type": "integer"
-                  },
-                  "score": {
-                    "type": "integer"
-                  },
-                  "scorePercent": {
-                    "type": "integer"
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/scoring/criteria/{id}",
-      "method": "PUT",
-      "operationId": "updateItem_3",
-      "summary": "Update scoring criteria item",
-      "description": "Updates the title, description, and/or score of a scoring criteria item. Duplicate title validation applies within the same parent.",
-      "tags": [
-        "Scoring Criteria"
-      ],
-      "parameters": [
-        {
-          "name": "id",
-          "in": "path",
-          "description": "Unique ID of the scoring criteria item to update",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object",
-              "properties": {
                 "title": {
                   "type": "string"
                 },
                 "description": {
                   "type": "string"
                 },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "SCORING_TYPE",
+                    "S_PART",
+                    "S_SCORING",
+                    "S_VALUE"
+                  ]
+                },
                 "score": {
                   "type": "integer",
                   "format": "int32"
+                },
+                "children": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "description": "(circular: ScoringCriteriaTreeSnapshotSaveRequest)"
+                  }
                 }
               }
             }
@@ -420,9 +316,6 @@
                   "title": {
                     "type": "string"
                   },
-                  "description": {
-                    "type": "string"
-                  },
                   "type": {
                     "type": "string",
                     "enum": [
@@ -432,14 +325,18 @@
                       "S_VALUE"
                     ]
                   },
-                  "depth": {
-                    "type": "integer"
-                  },
                   "score": {
                     "type": "integer"
                   },
                   "scorePercent": {
                     "type": "integer"
+                  },
+                  "children": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "description": "(circular: ScoringCriteriaTreeNodeDTO)"
+                    }
                   }
                 }
               }

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

@@ -6,9 +6,9 @@
     {
       "path": "/api/v2/synonym-excel/export",
       "method": "GET",
-      "operationId": "export_8",
+      "operationId": "export_9",
       "summary": "Export synonyms to Excel",
-      "description": "Exports synonym groups to an XLSX file and returns a download URI. Optional q filter narrows the exported groups before generating the workbook.",
+      "description": "This helper route exports the current synonym snapshot to XLSX and returns a download URI. The main JSON snapshot source and save routes are GET /api/v2/synonyms and PUT /api/v2/synonyms.",
       "tags": [
         "SynonymExcel"
       ],
@@ -24,7 +24,7 @@
         {
           "name": "useSynonym",
           "in": "query",
-          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "description": "Expand q with synonym dictionary terms (default: true)",
           "schema": {
             "type": "boolean",
             "default": true
@@ -56,9 +56,9 @@
     {
       "path": "/api/v2/synonym-excel/{uuid}",
       "method": "POST",
-      "operationId": "importExcel_1",
+      "operationId": "importExcel_2",
       "summary": "Import synonyms from Excel",
-      "description": "Imports synonym groups from a previously uploaded Excel file referenced by uuid. Supports row and column range selection and optional merge into existing groups by first term.",
+      "description": "This helper route parses an uploaded Excel file referenced by uuid and imports synonym groups using the requested row and column range. The main JSON save route remains PUT /api/v2/synonyms.",
       "tags": [
         "SynonymExcel"
       ],
@@ -75,9 +75,10 @@
         {
           "name": "rowStart",
           "in": "query",
-          "description": "Data start row (1-based, default: 1)",
+          "description": "Data start row (1-based, default: 2 to skip export header)",
           "schema": {
             "type": "integer",
+            "default": 2,
             "format": "int32"
           }
         },
@@ -102,7 +103,7 @@
         {
           "name": "merge",
           "in": "query",
-          "description": "Merge into existing groups when first term matches (default: false)",
+          "description": "Merge rows into matched groups (default: false)",
           "schema": {
             "type": "boolean"
           }
@@ -113,7 +114,99 @@
         "default": {
           "description": "default response",
           "content": {
-            "application/json": {}
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        }
+      },
+      "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/synonym-excel/{uuid}/read",
+      "method": "GET",
+      "operationId": "readExcel_1",
+      "summary": "Preview synonym import from Excel",
+      "description": "This helper route parses an uploaded Excel file referenced by uuid and returns the validated synonym groups that would be created or updated by import without writing to the database. The main JSON snapshot source and save routes remain GET /api/v2/synonyms and PUT /api/v2/synonyms.",
+      "tags": [
+        "SynonymExcel"
+      ],
+      "parameters": [
+        {
+          "name": "uuid",
+          "in": "path",
+          "description": "Uploaded file UUID",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "rowStart",
+          "in": "query",
+          "description": "Data start row (1-based, default: 2 to skip export header)",
+          "schema": {
+            "type": "integer",
+            "default": 2,
+            "format": "int32"
+          }
+        },
+        {
+          "name": "columnStart",
+          "in": "query",
+          "description": "Start column (1-based, default: 1)",
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        {
+          "name": "columnEnd",
+          "in": "query",
+          "description": "End column (1-based, required)",
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        {
+          "name": "merge",
+          "in": "query",
+          "description": "Merge rows into matched groups (default: false)",
+          "schema": {
+            "type": "boolean"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer"
+                    },
+                    "terms": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "termCount": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       },