fmea-api-mcp-server 1.1.7 → 1.1.8

package/dist/index.js

@@ -28,7 +28,7 @@ class ApiDocsServer {
     constructor() {
         this.server = new Server({
             name: "api-docs-mcp",
-            version: "1.1.7",
+            version: "1.1.8",
         }, {
             capabilities: {
                 resources: {},
@@ -124,7 +124,7 @@ class ApiDocsServer {
                     ],
                 };
             }
-            catch (error) {
+            catch (_error) {
                 throw new McpError(ErrorCode.InvalidRequest, `File not found: ${relativePath}`);
             }
         });

package/dist/intents.js

@@ -0,0 +1,34 @@
+/**
+ * Action Intent Detection Keywords
+ * Maps intent types to user query patterns for detecting user actions.
+ */
+export const ACTION_KEYWORDS = {
+    // Auth Actions
+    'logout': ['logout', 'sign out', 'log out', 'signoff', 'logoff'],
+    'login': ['login', 'signin', 'log in', 'sign in', 'authenticate', 'auth'],
+    // Data Transfer
+    'import': ['import', 'upload', 'restore', 'ingest'],
+    'export': ['export', 'download', 'backup', 'dump'],
+    // Monitoring
+    'MONITOR': ['monitor', 'track', 'audit', 'inspect', 'history', 'logs', 'usage', 'metrics', 'stats'],
+    // CRUD
+    'create': ['create', 'add', 'new', 'make', 'generate', 'register'],
+    'update': ['update', 'edit', 'change', 'modify', 'save', 'set', 'reset', 'password', 'refresh'],
+    'delete': ['delete', 'remove', 'drop', 'erase'],
+    'list': ['list', 'get', 'show', 'fetch', 'all', 'view', 'files', 'status', 'check'],
+};
+/**
+ * Order matters: More specific actions should be checked first.
+ * e.g., 'logout' should be checked before 'delete' to avoid misclassification.
+ */
+export const ACTION_PRIORITY = [
+    'logout',
+    'import',
+    'export',
+    'MONITOR',
+    'login',
+    'create',
+    'update',
+    'delete',
+    'list',
+];

package/dist/services/search/FileSearchService.js

@@ -11,7 +11,7 @@ export class FileSearchService {
         this.endpointsDir = endpointsDir;
         this.debugMode = debugMode;
     }
-    async search(query, filterMethod, filterVersion, page = 1, explicitPath) {
+    async search(query, filterMethod, filterVersion, page = 1, _explicitPath) {
         const files = await getAllFiles(this.endpointsDir);
         let documents = [];
         // 1. Prepare Documents (Corpus)
@@ -54,8 +54,9 @@ export class FileSearchService {
                     }
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // Ignore parse errors
+                console.error("FileSearchService.search: Error parsing endpoint file:", _e);
             }
         }
         const totalFound = documents.length;
@@ -70,7 +71,7 @@ export class FileSearchService {
         const rawQueryTokens = query.toLowerCase().split(/\s+/).filter(t => t.length > 0);
         // Check for Wildcard
         if (rawQueryTokens.length === 0 || (rawQueryTokens.length === 1 && rawQueryTokens[0] === "*")) {
-            const finalResults = documents.map(({ tokens, docLength, ...rest }) => rest);
+            const finalResults = documents.map(({ tokens: _tokens, docLength: _docLength, ...rest }) => rest);
             const { results, meta } = paginateResults(finalResults, page, DEFAULT_PAGE_SIZE);
             return {
                 results,
@@ -153,7 +154,7 @@ export class FileSearchService {
         const { results: slice, meta } = paginateResults(scoredDocs, page, DEFAULT_PAGE_SIZE);
         // Post-processing: Add warnings for V1 endpoints AND strip heavy fields
         const finalResults = await Promise.all(slice.map(async (item) => {
-            const { score, tokens, docLength, parameters, requestBody, responses, tags, file, ...lightweightItem } = item;
+            const { score, tokens: _tokens, docLength: _docLength, parameters: _parameters, requestBody: _requestBody, responses: _responses, tags: _tags, file: _file, ...lightweightItem } = item;
             if (lightweightItem.path && lightweightItem.path.includes("/v1/")) {
                 lightweightItem.warning = await this.generateDeprecationWarning(lightweightItem.path, lightweightItem.method);
             }
@@ -197,8 +198,9 @@ export class FileSearchService {
                     }
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // Ignore parse errors
+                console.error("FileSearchService.getDetails: Error parsing endpoint file:", _e);
             }
         }
         return null;
@@ -250,7 +252,10 @@ export class FileSearchService {
                     }
                 }
             }
-            catch (e) { }
+            catch (_e) {
+                // Ignore parse errors
+                console.error("FileSearchService.findEndpointInFiles: Error parsing endpoint file:", _e);
+            }
         }
         return false;
     }
@@ -282,7 +287,10 @@ export class FileSearchService {
                         }
                     }
                 }
-                catch (e) { }
+                catch (_e) {
+                    // Ignore parse errors
+                    console.error("FileSearchService.generateDeprecationWarning: Error parsing endpoint file:", _e);
+                }
             }
             if (domainExists) {
                 return `LEGACY: Direct v2 replacement not found, but newer '${domain}' related features exist in v2. Please search for '${domain}' in v2.`;

package/dist/services/search/IntentDetector.js

@@ -0,0 +1,44 @@
+import { ACTION_KEYWORDS, ACTION_PRIORITY } from '../../intents.js';
+import { RESOURCE_ALIASES } from '../../synonyms.js';
+export class IntentDetector {
+    detect(query) {
+        const lower = query.toLowerCase();
+        // Action Detection
+        let action = undefined;
+        for (const actionType of ACTION_PRIORITY) {
+            const keywords = ACTION_KEYWORDS[actionType];
+            if (keywords.some(k => lower.includes(k))) {
+                action = actionType;
+                break;
+            }
+        }
+        // Resource Detection
+        let resource = undefined;
+        const potentialResources = [];
+        for (const [resType, aliases] of Object.entries(RESOURCE_ALIASES)) {
+            const typeName = resType.replace(/-/g, ' ');
+            if (lower.includes(typeName)) {
+                potentialResources.push({ type: resType, length: typeName.length });
+            }
+            for (const alias of aliases) {
+                if (lower.includes(alias)) {
+                    potentialResources.push({ type: resType, length: alias.length });
+                }
+            }
+        }
+        potentialResources.sort((a, b) => b.length - a.length);
+        if (potentialResources.length > 0) {
+            resource = potentialResources[0].type;
+        }
+        if (!action && resource) {
+            action = 'list';
+        }
+        if (!resource && lower.includes('save work')) {
+            resource = 'project';
+        }
+        if (['login', 'logout'].includes(action || '') && resource !== 'oauth') {
+            resource = 'auth';
+        }
+        return { action, resource };
+    }
+}

package/dist/services/search/OramaSearchService.js

@@ -4,6 +4,7 @@ import fs from 'fs/promises';
 import { paginateResults, DEFAULT_PAGE_SIZE } from '../../utils/search-helper.js';
 import { endpointSchema } from './schema.js';
 import { RESOURCE_ALIASES } from '../../synonyms.js';
+import { ACTION_KEYWORDS, ACTION_PRIORITY } from '../../intents.js';
 import { ScoreCalculator } from '../../utils/ScoreCalculator.js';
 export class OramaSearchService {
     indexPath;
@@ -139,12 +140,9 @@ export class OramaSearchService {
             });
             // (Debug removed)
             // 5. Threshold Filtering & Mapping with Structural Analysis
-            const THRESHOLD = 0.25;
             const results = [];
             // Intent detection moved up.
-            let hitIdx = 0;
             for (const hit of searchResult.hits) {
-                hitIdx++;
                 let score = hit.score;
                 // (Debug removed)
                 // Structural Metadata from Index
@@ -334,28 +332,15 @@ export class OramaSearchService {
     }
     detectIntent(query) {
         const lower = query.toLowerCase();
+        // Action Detection - Use ACTION_PRIORITY for correct order
         let action = undefined;
-        // Action Detection
-        // [Round 14 Improvement] Specific Actions First
-        if (['logout', 'sign out', 'log out', 'signoff', 'logoff'].some(k => lower.includes(k)))
-            action = 'logout';
-        else if (['import', 'upload', 'restore', 'ingest'].some(k => lower.includes(k)))
-            action = 'import';
-        else if (['export', 'download', 'backup', 'dump'].some(k => lower.includes(k)))
-            action = 'export';
-        else if (['monitor', 'track', 'audit', 'inspect', 'history', 'logs', 'usage', 'metrics', 'stats'].some(k => lower.includes(k)))
-            action = 'MONITOR'; // [R15]
-        else if (['login', 'signin', 'log in', 'sign in', 'authenticate', 'auth'].some(k => lower.includes(k)))
-            action = 'login'; // [R16] Specific Login Action
-        // Core CRUD
-        else if (['create', 'add', 'new', 'make', 'generate', 'register'].some(k => lower.includes(k)))
-            action = 'create';
-        else if (['update', 'edit', 'change', 'modify', 'save', 'set', 'reset', 'password', 'refresh'].some(k => lower.includes(k)))
-            action = 'update'; // 'change', 'reset', 'refresh' -> update
-        else if (['delete', 'remove', 'drop', 'erase'].some(k => lower.includes(k)))
-            action = 'delete';
-        else if (['list', 'get', 'show', 'fetch', 'all', 'view', 'files', 'status', 'check'].some(k => lower.includes(k)))
-            action = 'list';
+        for (const actionType of ACTION_PRIORITY) {
+            const keywords = ACTION_KEYWORDS[actionType];
+            if (keywords.some(k => lower.includes(k))) {
+                action = actionType;
+                break;
+            }
+        }
         // Resource Detection
         // Simple lookup against known headers or extracting main noun
         let resource = undefined; // [Fix] Explicit declaration for scope visibility
@@ -403,37 +388,3 @@ export class OramaSearchService {
         return { action, resource };
     }
 }
-/**
- * Basic Levenshtein Distance implementation
- * Source: https://en.wikibooks.org/wiki/Algorithm_Implementation/Strings/Levenshtein_distance#JavaScript
- */
-function levenshtein(a, b) {
-    if (a.length === 0)
-        return b.length;
-    if (b.length === 0)
-        return a.length;
-    const matrix = [];
-    // increment along the first column of each row
-    for (let i = 0; i <= b.length; i++) {
-        matrix[i] = [i];
-    }
-    // increment each column in the first row
-    for (let j = 0; j <= a.length; j++) {
-        matrix[0][j] = j;
-    }
-    // Fill in the rest of the matrix
-    for (let i = 1; i <= b.length; i++) {
-        for (let j = 1; j <= a.length; j++) {
-            if (b.charAt(i - 1) == a.charAt(j - 1)) {
-                matrix[i][j] = matrix[i - 1][j - 1];
-            }
-            else {
-                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
-                Math.min(matrix[i][j - 1] + 1, // insertion
-                matrix[i - 1][j] + 1 // deletion
-                ));
-            }
-        }
-    }
-    return matrix[b.length][a.length];
-}

package/dist/utils/fs-helper.js

@@ -18,7 +18,7 @@ export async function getAllFiles(dir) {
             }
         }
     }
-    catch (err) {
+    catch (_err) {
         // Directory might not exist or be empty
         console.error(`Warning: Could not read directory ${dir}`);
     }

package/dist/utils/stemming.js

@@ -1,4 +1,3 @@
-// @ts-ignore
 import { stemmer } from "stemmer";
 // Domain terms that should NOT be stemmed
 export const DOMAIN_TERMS = new Set([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",
@@ -10,12 +10,15 @@
   "scripts": {
     "prebuild": "rm -rf endpoints && cp -r ../endpoints ./endpoints",
     "build": "tsc",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "start": "node dist/index.js",
     "watch": "tsc --watch",
     "test": "node tests/verify-mcp.cjs",
     "test:synonyms": "node tests/test-synonyms.mjs",
     "test:plural": "node tests/verify-plural-fix.mjs",
-    "test:search": "node tests/verify-search-enhancement.mjs",
+    "test:search": "node tests/search-json.mjs",
+    "test:search:verbose": "SEARCH_MODE=orama DEBUG_MODE=true node tests/verify-search-enhancement.mjs",
     "build:search-index": "npx tsx scripts/build-index.ts",
     "build-index": "npx tsx scripts/build-index.ts",
     "analyze-keywords": "npx tsx scripts/analyze-keywords.ts",
@@ -31,6 +34,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "eslint": "^9.39.2",
     "typescript": "^5.3.0"
   },
   "files": [