fmea-api-mcp-server 1.1.3 → 1.1.5

package/dist/index.js

@@ -7,55 +7,32 @@ import * as fsSync from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import { getSynonyms } from "./synonyms.js";
+// @ts-ignore
+import { stemmer } from "stemmer";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+// Domain terms that should NOT be stemmed
+const DOMAIN_TERMS = new Set([
+    "fmea", "bom", "api", "uuid", "id", "url", "uri", "json", "xml", "html", "css", "js", "ts"
+]);
 /**
- * Normalize token to singular form for better matching.
- * Handles common English plural patterns.
+ * Intelligent Stemming Helper with Domain Protection
+ * 1. Checks if token is a protected domain term (returns as-is)
+ * 2. Checks length (skips short words <= 2 chars)
+ * 3. Applies Porter Stemmer
  */
-function normalizeToken(token) {
-    const normalized = [token];
-    // Simple pluralization rules (token -> singular or singular -> plural)
-    const rules = [
-        // Remove 's' for common plurals
-        [/([a-z]+)s$/, '$1'],
-        // Remove 'es' for words ending with s, x, z, ch, sh
-        [/([a-z]+)es$/, '$1'],
-        // Remove 'ies' and replace with 'y'
-        [/([a-z]+)ies$/, '$1y'],
-        // Remove 'ves' and replace with 'f' (leaf -> leaves)
-        [/([a-z]+)ves$/, '$1f'],
-        // Remove 'men' and replace with 'man' (woman -> women)
-        [/([a-z]+)men$/, '$1man'],
-    ];
-    // Generate singular variants
-    for (const [pattern, replacement] of rules) {
-        if (pattern.test(token)) {
-            const singular = token.replace(pattern, replacement);
-            if (singular !== token && singular.length > 2) {
-                normalized.push(singular);
-            }
-            break;
-        }
+function stemToken(token) {
+    const lower = token.toLowerCase();
+    // Rule 1: Protected Domain Terms
+    if (DOMAIN_TERMS.has(lower)) {
+        return lower;
     }
-    // Add plural variant (append 's' if not ending with 's')
-    if (!token.endsWith('s') && token.length > 2) {
-        normalized.push(token + 's');
+    // Rule 2: Skip very short words
+    if (lower.length <= 2) {
+        return lower;
     }
-    return normalized;
-}
-/**
- * Expand tokens to include singular/plural variants
- */
-function expandTokenVariants(tokens) {
-    const variants = new Set(tokens);
-    for (const token of tokens) {
-        const normalized = normalizeToken(token);
-        for (const variant of normalized) {
-            variants.add(variant);
-        }
-    }
-    return variants;
+    // Rule 3: Apply Stemmer
+    return stemmer(lower);
 }
 // Directory where endpoint definitions are stored.
 // Priority:
@@ -334,13 +311,14 @@ class ApiDocsServer {
                             (endpoint.path || "").toLowerCase()
                         ].join(" ");
                         const tokens = searchableText.split(/\s+/).filter(t => t.length > 0);
-                        // Expand document tokens with singular/plural variants
-                        const expandedTokens = Array.from(expandTokenVariants(tokens));
+                        // Stemming tokens for Indexing
+                        const stemmedTokens = tokens.map(token => stemToken(token));
                         documents.push({
                             file: fileName,
                             ...endpoint,
-                            tokens: expandedTokens, // Expanded tokens for BM25 calculation
-                            docLength: expandedTokens.length
+                            // Use stemmed tokens for matching and BM25
+                            tokens: stemmedTokens,
+                            docLength: stemmedTokens.length
                         });
                     }
                 }
@@ -356,11 +334,10 @@ class ApiDocsServer {
                 message: `No results found for '${query}'.`
             };
         }
-        // 2. Query Processing (Synonyms + AND Logic)
+        // 2. Query Processing
         const rawQueryTokens = query.toLowerCase().split(/\s+/).filter(t => t.length > 0);
         // Check for Wildcard
         if (rawQueryTokens.length === 0 || (rawQueryTokens.length === 1 && rawQueryTokens[0] === "*")) {
-            // Slice for pagination
             const LIMIT = 10;
             const totalPages = Math.ceil(totalFound / LIMIT);
             const currentPage = Math.max(1, page);
@@ -372,15 +349,27 @@ class ApiDocsServer {
                 meta: { total: totalFound, page: currentPage, totalPages: totalPages }
             };
         }
-        // Filter Documents: AND Logic with Synonym Expansion + Plural/Singular Normalization
-        // Every query token (or one of its synonyms/plurals) MUST be present in the document
+        // Filter Documents: AND Logic with Stemming + Synonyms
+        // Step: Query Token -> Stem -> Synonyms -> Stem Synonyms -> Match Document Stems
         const filteredDocs = documents.filter(doc => {
             return rawQueryTokens.every(qToken => {
-                // Get synonyms first
-                const synonyms = getSynonyms(qToken);
-                // Expand with plural/singular variants
-                const expandedQuery = Array.from(expandTokenVariants(synonyms));
-                return expandedQuery.some((variant) => doc.tokens.includes(variant));
+                // 1. Stem the query token first (e.g. "parsing" -> "pars")
+                // But wait, synonyms often map "parse" -> "parsing".
+                // If we stem query first, we might miss synonym keys.
+                // BETTER STRATEGY: Get synonyms for RAW token, THEN stem everything.
+                const synonyms = getSynonyms(qToken); // e.g. "upload" -> ["post", "send"...]
+                // Stem the query token and all its synonyms
+                // e.g. "uploaded" -> stem("uploaded")="upload"
+                // synonyms("uploaded") might be empty if map uses root forms.
+                // So we should try:
+                // A. Synonyms of raw token
+                // B. Synonyms of stemmed token ? - Maybe overkill, let's stick to A for now.
+                const searchTerms = new Set();
+                synonyms.forEach(s => searchTerms.add(stemToken(s)));
+                // Also stem the query token itself regardless of synonyms
+                searchTerms.add(stemToken(qToken));
+                // Check if ANY of the stemmed search terms exist in the document's stemmed tokens
+                return Array.from(searchTerms).some(term => doc.tokens.includes(term));
             });
         });
         if (filteredDocs.length === 0) {
@@ -390,22 +379,15 @@ class ApiDocsServer {
             };
         }
         // 3. BM25 Calculation on Filtered Docs
-        // Context: We calculate stats based on the *filtered* corpus or *full* corpus?
-        // Standard BM25 usages often use full corpus stats for IDF. We will use full corpus stats.
         const k1 = 1.2;
         const b = 0.75;
         const avgdl = documents.reduce((acc, doc) => acc + doc.docLength, 0) / totalFound;
-        // Calculate IDF (using full corpus) for *expanded* tokens (synonyms + plurals)
-        // We expand query terms with both synonyms and plural/singular variants
+        // Calculate IDF (using full corpus) for stemmed terms
         const allQueryTerms = new Set();
         rawQueryTokens.forEach(t => {
             const synonyms = getSynonyms(t);
-            synonyms.forEach((s) => {
-                allQueryTerms.add(s);
-                // Also add plural/singular variants
-                const variants = normalizeToken(s);
-                variants.forEach(v => allQueryTerms.add(v));
-            });
+            synonyms.forEach(s => allQueryTerms.add(stemToken(s)));
+            allQueryTerms.add(stemToken(t));
         });
         const idf = {};
         for (const term of allQueryTerms) {
@@ -420,11 +402,11 @@ class ApiDocsServer {
         let scoredDocs = filteredDocs.map(doc => {
             let score = 0;
             for (const qToken of rawQueryTokens) {
-                // Find which synonyms + plural variants of qToken are present in this doc
                 const synonyms = getSynonyms(qToken);
-                const expandedQuery = Array.from(expandTokenVariants(synonyms));
-                const presentTerms = expandedQuery.filter((term) => doc.tokens.includes(term));
-                // Sum up scores for all matching terms (synonyms + plurals)
+                const searchTerms = new Set();
+                synonyms.forEach(s => searchTerms.add(stemToken(s)));
+                searchTerms.add(stemToken(qToken));
+                const presentTerms = Array.from(searchTerms).filter(term => doc.tokens.includes(term));
                 for (const term of presentTerms) {
                     const f_q = doc.tokens.filter((t) => t === term).length;
                     const numerator = idf[term] * f_q * (k1 + 1);
@@ -446,12 +428,8 @@ class ApiDocsServer {
         const slice = scoredDocs.slice(start, start + LIMIT);
         // Post-processing: Add warnings for V1 endpoints AND strip heavy fields
         const finalResults = await Promise.all(slice.map(async (item) => {
-            // Deconstruct to remove heavy fields (parameters, requestBody, responses, tags) and internal scoring props
             const { score, tokens, docLength, parameters, requestBody, responses, tags, file, ...lightweightItem } = item;
             if (lightweightItem.path && lightweightItem.path.includes("/v1/")) {
-                // Check for V1 Deprecation
-                // Always generate a warning for v1 endpoints using the 3-step logic
-                // We do this check after determining it is a v1 endpoint
                 lightweightItem.warning = await this.generateDeprecationWarning(lightweightItem.path, lightweightItem.method);
             }
             return lightweightItem;
@@ -488,10 +466,6 @@ class ApiDocsServer {
                             };
                             // Check for V1 Deprecation
                             if (apiPath.includes("/v1/")) {
-                                // Check for V1 Deprecation
-                                // Always generate a warning for v1 endpoints using the 3-step logic
-                                // We do this check regardless of whether a direct v2 exists or not, 
-                                // because generateDeprecationWarning handles all cases.
                                 result.warning = await this.generateDeprecationWarning(apiPath, method);
                             }
                             return result;

package/dist/synonyms.js

@@ -1,22 +1,49 @@
 export const SYNONYM_GROUPS = {
     // Read / Retrieve
-    "get": ["fetch", "retrieve", "read", "load", "find", "search", "query", "list", "show"],
-    "find": ["get", "search", "retrieve", "lookup", "show"],
-    "search": ["find", "get", "query", "lookup", "show"],
-    "show": ["get", "display", "view", "fetch", "find"],
-    "list": ["get", "all", "collection", "show", "summary"],
-    "summary": ["list", "all", "overview", "collection"],
+    "get": ["fetch", "retrieve", "read", "load", "find", "search", "query", "list", "show", "details"],
+    "find": ["get", "search", "retrieve", "lookup", "show", "detect", "locate"],
+    "search": ["find", "get", "query", "lookup", "show", "explore", "scan"],
+    "show": ["get", "display", "view", "fetch", "find", "present"],
+    "list": ["get", "all", "collection", "show", "summary", "index", "catalog"],
+    "summary": ["list", "all", "overview", "collection", "report", "stats"],
     // Create
-    "create": ["add", "insert", "make", "new", "post", "generate"],
-    "add": ["create", "insert", "append", "attach"],
-    "post": ["create", "add", "submit"],
+    "create": ["add", "insert", "make", "new", "post", "generate", "build", "register", "init"],
+    "add": ["create", "insert", "append", "attach", "include", "push"],
+    "post": ["create", "add", "submit", "send", "upload"],
+    "generate": ["create", "make", "build", "produce", "render"],
     // Update
-    "update": ["modify", "edit", "change", "save", "put", "patch", "set"],
-    "modify": ["update", "edit", "change", "adjust"],
-    "save": ["update", "store", "persist", "write"],
+    "update": ["modify", "edit", "change", "save", "put", "patch", "set", "refresh", "renew", "upgrade"],
+    "modify": ["update", "edit", "change", "adjust", "alter", "tweak"],
+    "save": ["update", "store", "persist", "write", "record", "commit"],
+    "set": ["update", "assign", "define", "configure", "specify"],
     // Delete
-    "delete": ["remove", "destroy", "clear", "erase", "drop"],
-    "remove": ["delete", "detach", "discard"]
+    "delete": ["remove", "destroy", "clear", "erase", "drop", "cancel", "archive", "unlink"],
+    "remove": ["delete", "detach", "discard", "exclude", "strip"],
+    // Processing / Execution (New)
+    "parse": ["parsing", "read", "decode", "interpret", "analyze", "extract", "scan"],
+    "parsing": ["parse", "reading", "decoding", "interpreting", "analyzing"],
+    "process": ["processing", "run", "execute", "handle", "compute", "perform", "analyzing"],
+    "processing": ["process", "running", "execution", "handling", "computing"],
+    "execute": ["run", "launch", "start", "trigger", "invoke", "call", "process"],
+    "run": ["execute", "start", "launch", "go", "process"],
+    // File / Data Handling (New)
+    "upload": ["post", "send", "import", "attach", "submit"],
+    "import": ["upload", "include", "load", "read", "ingest"],
+    "export": ["download", "save", "extract", "dump", "backup"],
+    "download": ["get", "fetch", "retrieve", "export", "pull"],
+    "copy": ["duplicate", "clone", "replicate", "mirror"],
+    "move": ["transfer", "relocate", "rename", "shift", "migrate"],
+    // Auth / Security (New)
+    "auth": ["authentication", "login", "signin", "verify", "check", "token", "credential"],
+    "login": ["signin", "auth", "authenticate", "connect", "access"],
+    "logout": ["signout", "disconnect", "exit", "leave"],
+    "verify": ["check", "validate", "confirm", "auth", "authorize", "test"],
+    "check": ["verify", "validate", "test", "inspect", "assess", "status"],
+    // General / Utilities (New)
+    "config": ["configuration", "settings", "setup", "options", "preferences", "profile"],
+    "settings": ["config", "preferences", "options", "profile", "properties"],
+    "connect": ["link", "join", "pair", "attach", "login", "bind"],
+    "disconnect": ["unlink", "detach", "logout", "close", "break"]
 };
 /**
  * Expands a single token into a list of synonyms including itself.

package/endpoints/README.md

@@ -46,6 +46,9 @@ To prevent ambiguity, follow these classification principles:
         - `operationId`: String (Unique identifier)
         - `parameters`: Array (Optional parameters)
         - `responses`: Object (Response definitions)
+    - `x-dependency-warning`: String (Optional). **URGENT**: When an endpoint depends on a prior initiation step (like file upload), this field MUST be included. It should state "REQUIRES PRIOR {ACTION} via [{METHOD} {PATH}]".
+
+### Example
 
 ### Example
 
@@ -56,3 +59,42 @@ endpoints/v1/projects/
   ├── data.json
   └── recommendations.json
 ```
+
+## Advanced Patterns & Dependencies
+
+To ensure AI agents correctly navigate complex workflows, strict patterns for dependency management are enforced.
+
+### 1. Documentation Standard: `x-dependency-warning`
+
+When an endpoint depends on a prior initiation step (e.g., file upload, login), the definition MUST include the `x-dependency-warning` field.
+
+-   **Field**: `x-dependency-warning`
+-   **Value Format**: `"REQUIRES PRIOR {ACTION} via [{METHOD} {PATH}]. {CONTEXT}"`
+-   **Example**:
+    ```json
+    "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint."
+    ```
+
+### 2. Workflow Pattern: File Upload & Processing
+
+This is the canonical pattern for handling file-based operations in this API.
+
+**The Workflow:**
+1.  **Initiator**: Client uploads a file via `POST /api/v2/files` -> Returns `{uuid}`.
+2.  **Consumer**: Client calls processing endpoints (e.g., `GET /api/v2/excel/{uuid}`) using that `{uuid}`.
+
+**AI Operational Protocol:**
+When this pattern is identified (via `x-dependency-warning` or path analysis), the AI MUST:
+
+1.  **Stop & Check**: If the user requests a "Consumer" action, verify if a file `uuid` is available in context.
+2.  **Propose Initiator**: If no `uuid` exists, explicitly propose the file upload step first.
+3.  **Auto-Chain**: Once the upload is complete, capture the `uuid` and automatically apply it to subsequent steps without asking the user.
+
+### 3. Identification Criteria
+
+Use these signals to identify dependency roles if `x-dependency-warning` is missing:
+
+| Role | Signals |
+| :--- | :--- |
+| **Initiator** | Path ends in `/files`, `/upload`; Method is `POST`; Returns an ID. |
+| **Consumer** | Path contains `{uuid}`; Logic involves parsing/extracting; Does *not* create `{uuid}` resource. |

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

@@ -6,6 +6,7 @@
     {
       "path": "/api/v1/projects/{projectId}/blockdiagrams/{blockId}/nodes/{nodeId}/failuremodes",
       "method": "GET",
+      "operationId": "findByNodeId",
       "summary": "Find Failure Modes",
       "description": "Retrieve failure modes for a specific node in a block diagram",
       "tags": [],
@@ -48,6 +49,7 @@
     {
       "path": "/api/v1/projects/{projectId}/blockdiagrams/{blockId}/nodes/{nodeId}/failuremodes",
       "method": "DELETE",
+      "operationId": "deleteByNodeId",
       "summary": "Delete Failure Modes",
       "description": "Delete failure modes for a specific node in a block diagram",
       "tags": [],
@@ -102,6 +104,7 @@
     {
       "path": "/api/v1/projects/{projectId}/blockdiagrams/{blockId}/failuremodes/import-from-project",
       "method": "POST",
+      "operationId": "importFromProject",
       "summary": "Import Failure Modes from Project",
       "description": "Import failure modes from another project",
       "tags": [],
@@ -144,6 +147,7 @@
     {
       "path": "/api/v1/projects/{projectId}/blockdiagrams/{blockId}/failuremodes",
       "method": "POST",
+      "operationId": "saveAll",
       "summary": "Save All Failure Modes",
       "description": "Save multiple failure modes for a block diagram",
       "tags": [],
@@ -190,6 +194,7 @@
     {
       "path": "/api/v1/projects/{projectId}/failuremods/{fmmId}/fmmdiagram",
       "method": "GET",
+      "operationId": "listFmmDiagram",
       "summary": "List FMM Diagram",
       "description": "Retrieve FMM diagram for a specific failure mode",
       "tags": [],
@@ -224,6 +229,7 @@
     {
       "path": "/api/v1/projects/{projectId}/failuremods/{topEventId}/fta",
       "method": "GET",
+      "operationId": "listFta",
       "summary": "List FTA",
       "description": "Retrieve Fault Tree Analysis for a failure mode",
       "tags": [],
@@ -258,6 +264,7 @@
     {
       "path": "/api/v1/projects/{projectId}/failuremods/{topEventId}/fta",
       "method": "POST",
+      "operationId": "saveFta",
       "summary": "Save FTA",
       "description": "Save Fault Tree Analysis for a failure mode",
       "tags": [],

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

@@ -185,6 +185,7 @@
       "path": "/api/v2/projects/{projectId}/block-diagrams-excel/{uuid}/data",
       "method": "GET",
       "operationId": "getData",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint.",
       "summary": "Get block diagram Excel data",
       "description": "Get data from block diagram Excel file",
       "tags": [],

package/endpoints/v2/excel/core.json

@@ -0,0 +1,73 @@
+{
+  "category": "excel",
+  "version": "v2",
+  "description": "Excel parsing endpoints for analyzing uploaded Excel files",
+  "endpoints": [
+    {
+      "path": "/api/v2/excel/{uuid}",
+      "method": "GET",
+      "summary": "Parse all sheets in Excel file",
+      "description": "Parse and retrieve all sheets from an uploaded Excel file identified by its UUID",
+      "tags": ["excel"],
+      "operationId": "parseAll",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint.",
+      "parameters": [
+        {
+          "name": "uuid",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "UUID of the uploaded Excel file"
+        }
+      ],
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/excel/{uuid}/sheets/{sheetIndex}",
+      "method": "GET",
+      "summary": "Parse specific sheet in Excel file",
+      "description": "Parse and retrieve a specific sheet from an uploaded Excel file by its index",
+      "tags": ["excel"],
+      "operationId": "parseSheet",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint.",
+      "parameters": [
+        {
+          "name": "uuid",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "UUID of the uploaded Excel file"
+        },
+        {
+          "name": "sheetIndex",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "description": "Zero-based index of the sheet to parse"
+        }
+      ],
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    }
+  ]
+}

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

@@ -6,6 +6,7 @@
     {
       "path": "/api/v2/projects/{projectId}/block-diagrams/{blockDiagramId}/failure-modes/{failureModeId}",
       "method": "GET",
+      "operationId": "getFailureMode",
       "summary": "Get Failure Mode",
       "description": "Retrieve a specific failure mode from a block diagram",
       "tags": [],
@@ -48,6 +49,7 @@
     {
       "path": "/api/v2/projects/{projectId}/failure-modes/{failureModeId}/fmm-diagram",
       "method": "PUT",
+      "operationId": "updateFMMDiagram",
       "summary": "Update FMM diagram",
       "description": "Update FMM diagram for a specific failure mode",
       "tags": [

package/endpoints/v2/fourm/core.json

@@ -6,6 +6,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "GET",
+      "operationId": "list",
       "summary": "List 4M analysis items",
       "description": "Retrieves a list of 4M (Man, Machine, Material, Environment) analysis items with optional filtering by project and tags",
       "tags": [],
@@ -48,6 +49,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "POST",
+      "operationId": "create",
       "summary": "Create 4M analysis item",
       "description": "Creates a new 4M (Man, Machine, Material, Environment) analysis item",
       "tags": [],
@@ -73,6 +75,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "GET",
+      "operationId": "get",
       "summary": "Get 4M analysis item by ID",
       "description": "Retrieves a specific 4M analysis item by its ID",
       "tags": [],
@@ -100,6 +103,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "PUT",
+      "operationId": "update",
       "summary": "Update 4M analysis item",
       "description": "Updates an existing 4M analysis item",
       "tags": [],
@@ -135,6 +139,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "DELETE",
+      "operationId": "delete",
       "summary": "Delete 4M analysis item",
       "description": "Deletes a 4M analysis item by its ID",
       "tags": [],

package/endpoints/v2/worksheets/core.json

@@ -0,0 +1,188 @@
+{
+  "category": "Worksheets",
+  "version": "v2",
+  "description": "Worksheet Core Operations",
+  "endpoints": [
+    {
+      "path": "/api/v2/projects/{projectId}/worksheets",
+      "method": "GET",
+      "summary": "Get worksheet summaries",
+      "description": "Retrieve all worksheet summaries for a specific project",
+      "tags": [],
+      "parameters": [
+        {
+          "name": "projectId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "operationId": "getSummaries",
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/projects/{projectId}/worksheets",
+      "method": "POST",
+      "summary": "Create worksheet",
+      "description": "Create a new worksheet for a specific project",
+      "tags": [],
+      "parameters": [
+        {
+          "name": "projectId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/WorksheetCreationDTO"
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "*/*": {}
+          }
+        }
+      },
+      "operationId": "create_4"
+    },
+    {
+      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
+      "method": "GET",
+      "summary": "Get worksheet by report number",
+      "description": "Retrieve a specific worksheet by its report number",
+      "tags": [],
+      "parameters": [
+        {
+          "name": "projectId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "reportNoSimple",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "$ref": "#/components/schemas/ReportNoSetDTO"
+          }
+        }
+      ],
+      "operationId": "get_5",
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
+      "method": "PUT",
+      "summary": "Update worksheet",
+      "description": "Update an existing worksheet by its report number",
+      "tags": [],
+      "parameters": [
+        {
+          "name": "projectId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "reportNoSimple",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "$ref": "#/components/schemas/ReportNoSetDTO"
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/WorksheetSaveDTO"
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "*/*": {}
+          }
+        }
+      },
+      "operationId": "save_7"
+    },
+    {
+      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
+      "method": "DELETE",
+      "summary": "Delete worksheet",
+      "description": "Delete a worksheet by its report number",
+      "tags": [],
+      "parameters": [
+        {
+          "name": "projectId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "reportNoSimple",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "$ref": "#/components/schemas/ReportNoSetDTO"
+          }
+        }
+      ],
+      "requestBody": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/WorksheetSaveDTO"
+            }
+          }
+        }
+      },
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "*/*": {}
+          }
+        }
+      },
+      "operationId": "delete_4"
+    }
+  ]
+}

package/endpoints/v2/worksheets/excel.json

@@ -44,7 +44,8 @@
           }
         }
       },
-      "operationId": "update_4"
+      "operationId": "update_4",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint."
     },
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{uuid}",
@@ -87,7 +88,8 @@
           }
         }
       },
-      "operationId": "add"
+      "operationId": "add",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint."
     },
     {
       "path": "/api/v2/projects/{projectId}/worksheet-excel/{reportNoSimple}",
@@ -148,6 +150,7 @@
         }
       ],
       "operationId": "getMetadata",
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file ID returned by the upload endpoint.",
       "responses": {
         "default": {
           "description": "default response",

package/endpoints/v2/worksheets/management.json

@@ -3,67 +3,6 @@
   "version": "v2",
   "description": "Worksheet Management Operations",
   "endpoints": [
-    {
-      "path": "/api/v2/projects/{projectId}/worksheets",
-      "method": "GET",
-      "summary": "Get worksheet summaries",
-      "description": "Retrieve all worksheet summaries for a specific project",
-      "tags": [],
-      "parameters": [
-        {
-          "name": "projectId",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        }
-      ],
-      "operationId": "getSummaries",
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {}
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/projects/{projectId}/worksheets",
-      "method": "POST",
-      "summary": "Create worksheet",
-      "description": "Create a new worksheet for a specific project",
-      "tags": [],
-      "parameters": [
-        {
-          "name": "projectId",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/WorksheetCreationDTO"
-            }
-          }
-        }
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "*/*": {}
-          }
-        }
-      },
-      "operationId": "create_4"
-    },
     {
       "path": "/api/v2/projects/{projectId}/worksheets/failuremode/{failureModeId}",
       "method": "GET",
@@ -140,126 +79,6 @@
         }
       }
     },
-    {
-      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
-      "method": "GET",
-      "summary": "Get worksheet by report number",
-      "description": "Retrieve a specific worksheet by its report number",
-      "tags": [],
-      "parameters": [
-        {
-          "name": "projectId",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        },
-        {
-          "name": "reportNoSimple",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "$ref": "#/components/schemas/ReportNoSetDTO"
-          }
-        }
-      ],
-      "operationId": "get_5",
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "application/json": {}
-          }
-        }
-      }
-    },
-    {
-      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
-      "method": "PUT",
-      "summary": "Update worksheet",
-      "description": "Update an existing worksheet by its report number",
-      "tags": [],
-      "parameters": [
-        {
-          "name": "projectId",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        },
-        {
-          "name": "reportNoSimple",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "$ref": "#/components/schemas/ReportNoSetDTO"
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/WorksheetSaveDTO"
-            }
-          }
-        }
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "*/*": {}
-          }
-        }
-      },
-      "operationId": "save_7"
-    },
-    {
-      "path": "/api/v2/projects/{projectId}/worksheets/{reportNoSimple}",
-      "method": "DELETE",
-      "summary": "Delete worksheet",
-      "description": "Delete a worksheet by its report number",
-      "tags": [],
-      "parameters": [
-        {
-          "name": "projectId",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "type": "string"
-          }
-        },
-        {
-          "name": "reportNoSimple",
-          "in": "path",
-          "required": true,
-          "schema": {
-            "$ref": "#/components/schemas/ReportNoSetDTO"
-          }
-        }
-      ],
-      "requestBody": {
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/WorksheetSaveDTO"
-            }
-          }
-        }
-      },
-      "responses": {
-        "default": {
-          "description": "default response",
-          "content": {
-            "*/*": {}
-          }
-        }
-      },
-      "operationId": "delete_4"
-    },
     {
       "path": "/api/v2/projects/{projectId}/worksheets/{reportNo}/headers",
       "method": "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",
@@ -15,6 +15,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
+    "stemmer": "^2.0.1",
     "zod": "^3.22.4"
   },
   "devDependencies": {