npm - fmea-api-mcp-server - Versions diffs - 1.1.53 → 1.1.55 - Mend

fmea-api-mcp-server 1.1.53 → 1.1.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/data/changelog/1.1.46.json +20 -0
package/data/changelog/1.1.47.json +1604 -0
package/data/changelog/1.1.48.json +1345 -0
package/data/changelog/1.1.49.json +187 -0
package/data/changelog/1.1.51.json +310 -0
package/data/changelog/1.1.52.json +11 -0
package/data/changelog/1.1.53.json +11 -0
package/data/changelog.json +11 -0
package/data/enums.json +565 -0
package/dist/index.js +71 -12
package/package.json +1 -1

package/data/enums.json ADDED Viewed

@@ -0,0 +1,565 @@
+{
+  "generated_at": "2026-03-21T23:44:38.946938",
+  "count": 70,
+  "enums": {
+    "ErrorCode": [
+      "INVALID_REQUEST_TYPE_ERROR",
+      "INVALID_REQUEST_ERROR",
+      "INVALID_PARAMETER_ERROR",
+      "TIMEOUT_ERROR",
+      "BAD_FORMAT_ERROR",
+      "METHOD_NOT_ALLOWED_ERROR",
+      "DATA_TYPE_ERROR",
+      "DATA_RANGE_ERROR",
+      "REQUEST_LIMIT_EXCEEDED",
+      "DUPLICATE_ERROR",
+      "DUPLICATED_USER_ID",
+      "WORKSHEET_ALREADY_EXISTS",
+      "ALREADY_PROJECT_MEMBER",
+      "ALREADY_PROCESSED_REQUEST",
+      "PROJECT_LOCKED",
+      "INTERNAL_SERVER_ERROR",
+      "DB_ERROR",
+      "SERVER_TIMEOUT_ERROR",
+      "NOT_FOUND",
+      "PROJECT_NOT_FOUND",
+      "PROJECT_JOIN_REQUEST_NOT_FOUND",
+      "DIVISION_NOT_FOUND",
+      "BLOCK_DIAGRAM_NOT_FOUND",
+      "FAILURE_MODE_NOT_FOUND",
+      "WORKSHEET_NOT_FOUND",
+      "WORKSHEET_TEMPLATE_NOT_FOUND",
+      "USER_NOT_FOUND",
+      "FILE_NOT_FOUND",
+      "EXPORT_HEADER_NOT_FOUND",
+      "BLOCK_DIAGRAM_NODE_NOT_FOUND",
+      "BLOCK_DIAGRAM_TYPE_NOT_FOUND",
+      "KNOWLEDGE_NOT_FOUND",
+      "NOTICE_NOT_FOUND",
+      "FILE_READ_ERROR",
+      "UNAUTHORIZED",
+      "AUTHENTICATION_ERROR",
+      "ACCESS_DENIED_ERROR",
+      "FORBIDDEN",
+      "USER_INACTIVATED",
+      "UNSUPPORTED_OPERATION_ERROR",
+      "DEPRECATED_ENDPOINT_ERROR",
+      "NOT_IMPLEMENTED"
+    ],
+    "AuthenticationMethod": [
+      "BASIC_AUTH",
+      "BEARER_TOKEN",
+      "API_KEY"
+    ],
+    "FTANodeType": [
+      "EVENT",
+      "BASIC_EVENT",
+      "UNDEVELOPED_EVENT",
+      "NORMAL_EVENT",
+      "TRANSFER_SYMBOL_IN",
+      "TRANSFER_SYMBOL_OUT",
+      "AND_GATE",
+      "OR_GATE",
+      "INHIBIT_GATE",
+      "NOT_GATE",
+      "MODIFIER_AND",
+      "MODIFIER_OR"
+    ],
+    "ProjectType": [
+      "DESIGN",
+      "PROCESS",
+      "EQUIPMENT",
+      "FA",
+      "FTA",
+      "CPLAN"
+    ],
+    "RecommendationRowStatus": [
+      "UNKNOWN",
+      "COMPLETED",
+      "IN_PROGRESS",
+      "DELAY"
+    ],
+    "TokenType": [
+      "BASIC",
+      "BEARER"
+    ],
+    "UserLevel": [
+      "ADMIN",
+      "NORMAL",
+      "READER"
+    ],
+    "ValidationType": [
+      "NOT_FOUND",
+      "CONFLICT",
+      "INVALID_PARAMETER"
+    ],
+    "ActionType": [
+      "ADD",
+      "DELETE",
+      "UPDATE"
+    ],
+    "BlockNodeCategory": [
+      "FUNCTION",
+      "STRUCTURE",
+      "PROCESS",
+      "SUPER_SYSTEM"
+    ],
+    "RatingCategory": [
+      "SEVERITY",
+      "OCCURRENCE",
+      "DETECTION"
+    ],
+    "APType": [
+      "AIAG",
+      "MSR"
+    ],
+    "ActionPriority": [
+      "LOW",
+      "MEDIUM",
+      "HIGH"
+    ],
+    "BlockNodeExcelColumnMapping": [
+      "LEVEL",
+      "ITEM",
+      "FUNCTION",
+      "REQUIREMENT",
+      "PROCESS_NUMBER",
+      "PROCESS_SYMBOL",
+      "PROCESS_CATEGORY",
+      "ORDER",
+      "TYPE"
+    ],
+    "ClientIdMappingTarget": [
+      "WORKSHEET_ID",
+      "FAILURE_MODE_WORKSHEET_ID",
+      "WORKSHEET_ROW_ID",
+      "BLOCK_NODE_ID",
+      "BLOCK_REFERENCED_ID",
+      "FMM_OBJECT_ID"
+    ],
+    "CauseClassification": [
+      "UNRATED",
+      "NO_CONTROL",
+      "BEFORE_ACTION",
+      "AFTER_ACTION"
+    ],
+    "ProjectStatusGroup": [
+      "IN_PROGRESS",
+      "UNDER_REVIEW",
+      "COMPLETED",
+      "REFUSED"
+    ],
+    "RpnBucket": [
+      "RANGE_1_20",
+      "RANGE_21_40",
+      "RANGE_41_100",
+      "RANGE_101_200",
+      "RANGE_201_PLUS"
+    ],
+    "ConstraintDirection": [
+      "ANCESTOR",
+      "DESCENDANT"
+    ],
+    "ConstraintMatchType": [
+      "EXACT",
+      "CONTAINS"
+    ],
+    "TreeSearchQueryMode": [
+      "REFERENCE_NODE",
+      "ANCHOR_PATTERN",
+      "CONTEXT_COMPLETION"
+    ],
+    "ExcelFileStatus": [
+      "CREATABLE",
+      "UPDATABLE",
+      "OUTDATED",
+      "UNKNOWN"
+    ],
+    "WorksheetCreationType": [
+      "NEW",
+      "REVISION"
+    ],
+    "AdditionalInfoFieldType": [
+      "TEXT",
+      "DATE",
+      "SELECT",
+      "LIST"
+    ],
+    "AdditionalInfoTypeMode": [
+      "TEXT",
+      "DATE",
+      "SELECT",
+      "LIST",
+      "LIST_PMS"
+    ],
+    "ApprovalAction": [
+      "APPROVE",
+      "REFUSE",
+      "ACCEPT",
+      "REJECT"
+    ],
+    "ApprovalBoardStatus": [
+      "REVIEW",
+      "ASK_MODIFY",
+      "REVIEWED",
+      "APPROVE",
+      "ASK_MODIFY_REVIEWED",
+      "APPROVED",
+      "SCORE",
+      "ASK_MODIFY_APPROVED",
+      "REFUSED",
+      "SCORE_PASS",
+      "SCORE_FAIL",
+      "COMPLETED",
+      "CONFIRM_VALIDITY",
+      "DATE_EXPIRED"
+    ],
+    "ApprovalStatus": [
+      "IN_PROGRESS",
+      "REFUSED",
+      "SELF_COMPLETED",
+      "REVIEW",
+      "APPROVE",
+      "SCORE",
+      "COMPLETED",
+      "ASK_MODIFY_REVIEW",
+      "ASK_MODIFY_APPROVE",
+      "DELAY",
+      "NA",
+      "CAN_MODIFY"
+    ],
+    "ApprovalStep": [
+      "WRITE",
+      "REVIEW",
+      "APPROVE",
+      "SCORE"
+    ],
+    "ApprovalStepItem": [
+      "REVIEW_OPINION",
+      "APPROVAL_OPINION",
+      "APPROVAL_DECISION",
+      "REVIEW_REFUSAL",
+      "SCORE_PASS",
+      "SCORE_FAIL",
+      "SCORE_REFUSAL"
+    ],
+    "ApprovalStepStatus": [
+      "PENDING",
+      "ACTIVE",
+      "COMPLETED",
+      "REFUSED"
+    ],
+    "BlockDiagramType": [
+      "FUNCTION",
+      "STRUCTURE",
+      "FUNCTION_STRUCTURE",
+      "STRUCTURE_FUNCTION",
+      "PROCESS",
+      "SUPER_SYSTEM",
+      "FUNCTION_ANALYSIS"
+    ],
+    "BlockNodeType": [
+      "FUNCTION",
+      "PART",
+      "SUB_FUNCTION",
+      "ASSEMBLY",
+      "NEW_CHANGE_ASSEMBLY",
+      "NEW_CHANGE_PART",
+      "NEW_CHANGE_PROCESS",
+      "SUPER_SYSTEM",
+      "TARGET"
+    ],
+    "BoardCategory": [
+      "APPROVAL",
+      "BLOCK_DIAGRAM",
+      "FMM_DIAGRAM",
+      "WORKSHEET",
+      "FTA",
+      "CONTROL_PLAN",
+      "INFO"
+    ],
+    "SymbolType": [
+      "TEXT",
+      "IMAGE"
+    ],
+    "AccessScope": [
+      "MY",
+      "DIVISION",
+      "ALL"
+    ],
+    "MailStatus": [
+      "CREATED",
+      "ACCEPTED",
+      "SEND_READY",
+      "SEND_OK",
+      "UNUSED",
+      "TEMPLATE_INFO_NOT_FOUND",
+      "TEMPLATE_FILE_NOT_FOUND",
+      "TEMPLATE_ERROR",
+      "UNKNOWN_DATA_MODEL_TYPE",
+      "DATA_MODEL_ERROR",
+      "CONNECTION_FAIL",
+      "SEND_FAIL",
+      "UNKNOWN_ERROR",
+      "HOLD"
+    ],
+    "FMMDiagramType": [
+      "UNUSED",
+      "NOT_SELECTED",
+      "TYPE_A",
+      "TYPE_C"
+    ],
+    "FmCheckpointNodeType": [
+      "ROOT",
+      "CATEGORY",
+      "GROUP",
+      "ITEM"
+    ],
+    "FMMBlockDiagramType": [
+      "FMM_FUNCTION",
+      "FMM_STRUCTURE",
+      "FMM_FUNCTION_STRUCTURE",
+      "FMM_STRUCTURE_FUNCTION",
+      "FMM_PROCESS"
+    ],
+    "FMMObjectType": [
+      "FAILURE_MODE",
+      "EFFECT",
+      "ITEM",
+      "EXTERNAL_ITEM",
+      "GROUP",
+      "CAUSE_U",
+      "CAUSE_I",
+      "STRESS",
+      "DESIGN",
+      "PROCESS"
+    ],
+    "FourMCategory": [
+      "MAN",
+      "MACHINE",
+      "MATERIAL",
+      "ENVIRONMENT"
+    ],
+    "CauseAnalysisLevel": [
+      "FIRST",
+      "SECOND"
+    ],
+    "ProjectJoinRequestStatus": [
+      "PENDING",
+      "APPROVED",
+      "REJECTED"
+    ],
+    "ProjectMemberRole": [
+      "LEADER",
+      "MEMBER",
+      "REVIEWER",
+      "APPROVAL",
+      "COMPLETION_REVIEWER",
+      "NONE"
+    ],
+    "ProjectTag": [
+      "NORMAL",
+      "MASTER",
+      "REFERENCE"
+    ],
+    "RecommendationItemStatus": [
+      "NOT_COMPLETED",
+      "IN_PROGRESS",
+      "DELAY",
+      "COMPLETED",
+      "ALL"
+    ],
+    "ScoringItemType": [
+      "SCORING_TYPE",
+      "S_PART",
+      "S_SCORING",
+      "S_VALUE"
+    ],
+    "FailureModeSortField": [
+      "NAME",
+      "RPN"
+    ],
+    "ProjectGroupBy": [
+      "DIVISION",
+      "ITEM"
+    ],
+    "MailTemplateCode": [
+      "CA0",
+      "CA1",
+      "CF1",
+      "CF2",
+      "CR3",
+      "CS1",
+      "CS2",
+      "FA2",
+      "FW2",
+      "HD0",
+      "NPW",
+      "PA2",
+      "PA4",
+      "PA6",
+      "PA8",
+      "PA9",
+      "PF2",
+      "PF4",
+      "PF6",
+      "PF8",
+      "PF9",
+      "PS0",
+      "PS2",
+      "PS4",
+      "PS6",
+      "PS8",
+      "PS9",
+      "PW1",
+      "PW2",
+      "PW4",
+      "PW6",
+      "PW8",
+      "PW9",
+      "TL0",
+      "TL1",
+      "PJ1",
+      "PJ2",
+      "PJ3",
+      "PJ4",
+      "PJ5"
+    ],
+    "ColumnDataType": [
+      "integer",
+      "boolean",
+      "text",
+      "date",
+      "refer"
+    ],
+    "ColumnTypeGroup": [
+      "ITEM_FUNCTION_GROUP",
+      "FAILURE_MODE_GROUP",
+      "FAILURE_EFFECT_GROUP",
+      "FAILURE_CAUSE_GROUP",
+      "RECOMMENDED_ACTION_GROUP"
+    ],
+    "WorksheetTemplateCategory": [
+      "AIAG",
+      "AIAG-VDA",
+      "FMEA-MSR",
+      "STANDARD"
+    ],
+    "ConditionLibraryType": [
+      "STRESS",
+      "DESIGN",
+      "PROCESS"
+    ],
+    "DocumentCategory": [
+      "SYSTEM_DEFINITION",
+      "WORKSHEET",
+      "BLOCK_DIAGRAM",
+      "FMM_DIAGRAM"
+    ],
+    "DocumentType": [
+      "UPLOAD",
+      "URL"
+    ],
+    "HighItemType": [
+      "HIGH_ITEM",
+      "HIGH_EFFECT"
+    ],
+    "RevisionActionCode": [
+      "CREATE_PROJECT",
+      "MODIFY_PROJECT",
+      "DELETE_PROJECT",
+      "JOIN_REQUEST",
+      "JOIN_APPROVED",
+      "JOIN_REJECTED",
+      "CREATE",
+      "COPY",
+      "MODIFY",
+      "UPDATE",
+      "REVISE",
+      "DELETE"
+    ],
+    "RevisionMenuCode": [
+      "PROJECT",
+      "BLOCK",
+      "FMM",
+      "WORKSHEET",
+      "ATTACHED_FILE",
+      "WORKSHEET_UNIT",
+      "CONTROL_PLAN"
+    ],
+    "SystemDefinitionConditionScope": [
+      "OWNED",
+      "CANDIDATE",
+      "ALL"
+    ],
+    "MatchType": [
+      "EXACT",
+      "CONTAINS"
+    ],
+    "ScoreFactor": [
+      "NODE_TYPE_MATCH",
+      "ATTRIBUTE_MATCH",
+      "ANCESTOR_MATCH",
+      "DESCENDANT_MATCH",
+      "TEXT_RELEVANCE",
+      "DEPTH_PENALTY"
+    ],
+    "ValidationStatus": [
+      "UNKNOWN",
+      "DUPLICATED_VALUE",
+      "INVALID_VALUE",
+      "INVALID_ID",
+      "INVALID_TYPE",
+      "INVALID_DATA_TYPE_INTEGER",
+      "INVALID_DATA_TYPE_BOOLEAN",
+      "INVALID_DATE_FORMAT",
+      "VALUE_OUT_OF_RANGE",
+      "ID_NOT_FOUND",
+      "REFERENCED_ID_NOT_FOUND",
+      "MISSING_ROOT",
+      "INVALID_RELATIONSHIP",
+      "ALREADY_PROCESSED"
+    ],
+    "MarkerType": [
+      "EXTERNAL_ITEM"
+    ],
+    "Risk": [
+      "H",
+      "M",
+      "L",
+      "NA"
+    ],
+    "WsColumnStylePreset": [
+      "WS_HEADER_LIGHT_TURQUOISE",
+      "WS_HEADER_GREY_25",
+      "WS_HEADER_LIGHT_BLUE",
+      "WS_HEADER_LIGHT_YELLOW",
+      "WS_HEADER_LIGHT_RED",
+      "WS_DATA",
+      "WS_DATA_READONLY"
+    ],
+    "WsFontStylePreset": [
+      "WS_FONT",
+      "WS_FONT_EFFECT",
+      "WS_FONT_DESIGN",
+      "WS_FONT_I_CAUSE",
+      "WS_FONT_PROCESS",
+      "WS_FONT_STRESS",
+      "WS_FONT_U_CAUSE",
+      "WS_FONT_CAUSE",
+      "WS_FONT_R",
+      "WS_FONT_RED",
+      "WS_FONT_GREEN",
+      "WS_FONT_EXTERNAL_ITEM"
+    ],
+    "WorksheetSaveFields": [
+      "FAILURE_MODE_WORKSHEET_ID",
+      "ROW_ID"
+    ],
+    "ExcelreportTemplate": [
+      "IDX_1",
+      "IDX_2",
+      "IDX_3"
+    ]
+  }
+}

package/dist/index.js CHANGED Viewed

@@ -28,7 +28,7 @@ class ApiDocsServer {
     constructor() {
         this.server = new Server({
             name: "api-docs-mcp",
-            version: "1.1.53",
+            version: "1.1.55",
         }, {
             capabilities: {
                 resources: {},
@@ -192,7 +192,7 @@ class ApiDocsServer {
                     },
                     {
                         name: "get_changes",
-                        description: "Get API endpoint changelog. Shows what endpoints/parameters were added, removed, or modified across versions.",
+                        description: "Get API endpoint changelog. Shows what endpoints/parameters were added, removed, or modified across versions. Includes enum changes when available.",
                         inputSchema: {
                             type: "object",
                             properties: {
@@ -208,6 +208,20 @@ class ApiDocsServer {
                             required: [],
                         },
                     },
+                    {
+                        name: "get_enums",
+                        description: "Get all Java enum definitions from the API codebase. Returns enum names and their constant values.",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                name: {
+                                    type: "string",
+                                    description: "Filter by enum name (partial match, case-insensitive). Omit to get all enums.",
+                                },
+                            },
+                            required: [],
+                        },
+                    },
                 ],
             };
         });
@@ -315,14 +329,8 @@ class ApiDocsServer {
                 };
             }
             if (request.params.name === "get_changes") {
-                const changelogPath = path.join(DATA_DIR, "changelog.json");
+                const changelogDir = path.join(DATA_DIR, "changelog");
                 try {
-                    const raw = await fs.readFile(changelogPath, "utf-8");
-                    const changelog = JSON.parse(raw);
-                    const sinceVersion = request.params.arguments?.since_version
-                        ? String(request.params.arguments.since_version) : undefined;
-                    const exactVersion = request.params.arguments?.version
-                        ? String(request.params.arguments.version) : undefined;
                     const parseVer = (v) => v.split(".").map(Number);
                     const cmpVer = (a, b) => {
                         for (let i = 0; i < 3; i++) {
@@ -331,18 +339,41 @@ class ApiDocsServer {
                         }
                         return 0;
                     };
+                    // Read all version files from changelog/
+                    const files = await fs.readdir(changelogDir).catch(() => []);
+                    const changelog = {};
+                    for (const file of files) {
+                        if (!file.endsWith(".json"))
+                            continue;
+                        const ver = file.replace(".json", "");
+                        const raw = await fs.readFile(path.join(changelogDir, file), "utf-8");
+                        changelog[ver] = JSON.parse(raw);
+                    }
+                    const sinceVersion = request.params.arguments?.since_version
+                        ? String(request.params.arguments.since_version) : undefined;
+                    const exactVersion = request.params.arguments?.version
+                        ? String(request.params.arguments.version) : undefined;
                     let result;
                     if (exactVersion) {
                         result = changelog[exactVersion] ? { [exactVersion]: changelog[exactVersion] } : {};
                     }
                     else if (sinceVersion) {
                         const sinceArr = parseVer(sinceVersion);
-                        result = Object.fromEntries(Object.entries(changelog).filter(([v]) => cmpVer(parseVer(v), sinceArr) >= 0));
+                        result = Object.fromEntries(Object.entries(changelog)
+                            .filter(([v]) => v !== "next" && cmpVer(parseVer(v), sinceArr) >= 0)
+                            .sort(([a], [b]) => cmpVer(parseVer(a), parseVer(b))));
+                        // include "next" if present
+                        if (changelog["next"])
+                            result["next"] = changelog["next"];
                     }
                     else {
-                        // Latest version only
-                        const versions = Object.keys(changelog).sort((a, b) => cmpVer(parseVer(b), parseVer(a)));
+                        // Latest numbered version only (+ "next" if present)
+                        const versions = Object.keys(changelog)
+                            .filter(v => v !== "next")
+                            .sort((a, b) => cmpVer(parseVer(b), parseVer(a)));
                         result = versions.length > 0 ? { [versions[0]]: changelog[versions[0]] } : {};
+                        if (changelog["next"])
+                            result["next"] = changelog["next"];
                     }
                     return {
                         content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
@@ -354,6 +385,34 @@ class ApiDocsServer {
                     };
                 }
             }
+            if (request.params.name === "get_enums") {
+                const enumsPath = path.join(DATA_DIR, "enums.json");
+                try {
+                    const raw = await fs.readFile(enumsPath, "utf-8");
+                    const data = JSON.parse(raw);
+                    const nameFilter = request.params.arguments?.name
+                        ? String(request.params.arguments.name).toLowerCase() : undefined;
+                    let enums = data.enums ?? {};
+                    if (nameFilter) {
+                        enums = Object.fromEntries(Object.entries(enums).filter(([k]) => k.toLowerCase().includes(nameFilter)));
+                    }
+                    return {
+                        content: [{
+                                type: "text",
+                                text: JSON.stringify({
+                                    generated_at: data.generated_at,
+                                    count: Object.keys(enums).length,
+                                    enums,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                catch (_error) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ message: "No enum data available. Run collect_enums.py first." }) }],
+                    };
+                }
+            }
             throw new McpError(ErrorCode.MethodNotFound, "Tool not found");
         });
     }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.53",
+  "version": "1.1.55",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",