fa-mcp-sdk 0.4.76 → 0.4.77

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.4.76",
+  "version": "0.4.77",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",
@@ -31,9 +31,13 @@
     "clean": "rimraf dist",
     "cb": "npm run clean && npm run build",
     "dev": "tsc --watch",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "lint-fix-build": "eslint --fix . && rimraf dist && tsc && node scripts/copy-static.js",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "quality": "npm run lint && npm run format",
+    "quality:fix": "npm run lint:fix && npm run format:fix",
+    "lint-fix-build": "oxlint --fix . && oxfmt . && rimraf dist && tsc && node scripts/copy-static.js",
     "ci": "node --no-deprecation ./scripts/npm/run.js",
     "reinstall": "node --no-deprecation ./scripts/npm/run.js reinstall",
     "typecheck": "tsc --noEmit",
@@ -100,7 +104,8 @@
     "@types/mssql": "^9.1.11",
     "@types/node": "^25.5.2",
     "@types/swagger-ui-express": "^4.1.8",
-    "eslint-config-at-26-2": "^26.4.9",
+    "oxfmt": "^0.48.0",
+    "oxlint": "^1.63.0",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.2"
   }

package/{cli-template/.claude/hooks/eslint-fix.cjs → scripts/cc-hook-oxlint-oxfmt-fix.cjs}

@@ -1,100 +1,109 @@
-#!/usr/bin/env node
-
-/**
- * ESLint Auto-Fix Hook for Claude Code
- * Automatically formats JS/TS files after Write/Edit operations
- */
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const LOG_FILE = path.join(__dirname, 'log.log');
-const IS_LOG = process.env.CLAUDE_HOOK_LOG === 'true';
-
-function log (message) {
-  if (IS_LOG) {
-    const timestamp = new Date().toISOString();
-    const line = `[${timestamp}] ${message}\n`;
-    fs.appendFileSync(LOG_FILE, line);
-  }
-}
-
-function main () {
-  let input = '';
-
-  try {
-    // Read JSON input from stdin
-    input = fs.readFileSync(0, 'utf-8');
-    log(`Input received:\n====\n${input.substring(0, 200)}...\n====\n`);
-
-    const data = JSON.parse(input);
-    const filePath = data?.tool_input?.file_path;
-
-    if (!filePath) {
-      log('No file_path found in input');
-      process.exit(0);
-    }
-
-    log(`File path: ${filePath}`);
-
-    // Check if file extension is .js or .ts
-    if (!/\.(js|ts)$/.test(filePath)) {
-      log(`Skipping non-JS/TS file: ${filePath}`);
-      process.exit(0);
-    }
-
-    // Exclude files in node_modules, dist, coverage, etc.
-    const excludePatterns = [
-      /node_modules/,
-      /[/\\]dist[/\\]/,
-      /[/\\]coverage[/\\]/,
-      /\.d\.ts$/,
-    ];
-
-    for (const pattern of excludePatterns) {
-      if (pattern.test(filePath)) {
-        log(`Skipping excluded path: ${filePath}`);
-        process.exit(0);
-      }
-    }
-
-    // Get project directory from environment
-    const projectDir = process.env.CLAUDE_PROJECT_DIR;
-
-    if (!projectDir) {
-      log('CLAUDE_PROJECT_DIR not set');
-      process.exit(0);
-    }
-
-    log(`Project dir: ${projectDir}`);
-
-    // Change to project directory
-    process.chdir(projectDir);
-
-    // Run eslint --fix on the file
-    log(`Running ESLint on: ${filePath}`);
-
-    try {
-      const output = execSync(`npx eslint --fix "${filePath}"`, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-      log(`ESLint output: ${output || '(empty)'}`);
-      console.log(`🔧 Formatted: ${filePath}`);
-      console.log('✅ Formatted successfully');
-    } catch (eslintError) {
-      // ESLint returns non-zero on warnings/errors but file is still fixed
-      log(`ESLint warnings/errors: ${eslintError.message}`);
-      console.log(`⚠️ ESLint warnings/errors (file still saved)`);
-    }
-
-  } catch (error) {
-    log(`Error: ${error.message}\nStack: ${error.stack}`);
-  }
-
-  // Always exit 0 to not block Claude's operations
-  process.exit(0);
-}
-
-main();
+#!/usr/bin/env node
+
+/**
+ * Oxlint + Oxfmt Auto-Fix Hook for Claude Code
+ * Automatically lints and formats JS/TS files after Write/Edit operations
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const LOG_FILE = path.join(__dirname, 'log.log');
+const IS_LOG = process.env.CLAUDE_HOOK_LOG === 'true';
+
+function log(message) {
+  if (IS_LOG) {
+    const timestamp = new Date().toISOString();
+    const line = `[${timestamp}] ${message}\n`;
+    fs.appendFileSync(LOG_FILE, line);
+  }
+}
+
+function main() {
+  let input = '';
+
+  try {
+    // Read JSON input from stdin
+    input = fs.readFileSync(0, 'utf-8');
+    log(`Input received:\n====\n${input.substring(0, 200)}...\n====\n`);
+
+    const data = JSON.parse(input);
+    const filePath = data?.tool_input?.file_path;
+
+    if (!filePath) {
+      log('No file_path found in input');
+      process.exit(0);
+    }
+
+    log(`File path: ${filePath}`);
+
+    // Check if file extension is .js or .ts
+    if (!/\.(js|ts)$/.test(filePath)) {
+      log(`Skipping non-JS/TS file: ${filePath}`);
+      process.exit(0);
+    }
+
+    // Exclude files in node_modules, dist, coverage, etc.
+    const excludePatterns = [/node_modules/, /[/\\]dist[/\\]/, /[/\\]coverage[/\\]/, /\.d\.ts$/];
+
+    for (const pattern of excludePatterns) {
+      if (pattern.test(filePath)) {
+        log(`Skipping excluded path: ${filePath}`);
+        process.exit(0);
+      }
+    }
+
+    // Get project directory from environment
+    const projectDir = process.env.CLAUDE_PROJECT_DIR;
+
+    if (!projectDir) {
+      log('CLAUDE_PROJECT_DIR not set');
+      process.exit(0);
+    }
+
+    log(`Project dir: ${projectDir}`);
+
+    // Change to project directory
+    process.chdir(projectDir);
+
+    // Run oxlint --fix on the file
+    log(`Running Oxlint on: ${filePath}`);
+
+    try {
+      const output = execSync(`npx oxlint --fix "${filePath}"`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      log(`Oxlint output: ${output || '(empty)'}`);
+      console.log(`🔧 Linted: ${filePath}`);
+    } catch (oxlintError) {
+      // Oxlint returns non-zero on warnings/errors but file is still fixed
+      log(`Oxlint warnings/errors: ${oxlintError.message}`);
+      console.log(`⚠️ Oxlint warnings/errors (file still saved)`);
+    }
+
+    // Run oxfmt on the file
+    log(`Running Oxfmt on: ${filePath}`);
+
+    try {
+      const output = execSync(`npx oxfmt "${filePath}"`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      log(`Oxfmt output: ${output || '(empty)'}`);
+      console.log(`✨ Formatted: ${filePath}`);
+      console.log('✅ Done');
+    } catch (oxfmtError) {
+      log(`Oxfmt warnings/errors: ${oxfmtError.message}`);
+      console.log(`⚠️ Oxfmt warnings/errors (file still saved)`);
+    }
+  } catch (error) {
+    log(`Error: ${error.message}\nStack: ${error.stack}`);
+  }
+
+  // Always exit 0 to not block Claude's operations
+  process.exit(0);
+}
+
+main();

package/scripts/generate-jwt.js

@@ -22,7 +22,7 @@ import configModule from 'config';
 
 // ── CLI argument parsing ────────────────────────────────────────────
 
-function getArg (shortFlag, longFlag) {
+function getArg(shortFlag, longFlag) {
   const args = process.argv.slice(2);
   for (let i = 0; i < args.length; i++) {
     if (args[i] === shortFlag || args[i] === longFlag) {
@@ -84,13 +84,9 @@ if (!encryptKey || String(encryptKey).trim() === '' || encryptKey === '***') {
 // ── Encryption (mirrors src/core/auth/jwt.ts) ───────────────────────
 
 const ALGORITHM = 'aes-256-ctr';
-const KEY = crypto
-  .createHash('sha256')
-  .update(String(encryptKey))
-  .digest('base64')
-  .substring(0, 32);
+const KEY = crypto.createHash('sha256').update(String(encryptKey)).digest('base64').substring(0, 32);
 
-function encrypt (text) {
+function encrypt(text) {
   const buffer = Buffer.from(text);
   const iv = crypto.randomBytes(16);
   const cipher = crypto.createCipheriv(ALGORITHM, KEY, iv);
@@ -102,7 +98,7 @@ function encrypt (text) {
 
 let effectiveService = service;
 
-if ((!effectiveService || !effectiveService.trim())) {
+if (!effectiveService || !effectiveService.trim()) {
   let checkMCPName = false;
   try {
     checkMCPName = configModule.get('webServer.auth.jwtToken.checkMCPName');
@@ -158,7 +154,7 @@ if (paramsRaw && paramsRaw.trim()) {
   }
 }
 
-const expire = Date.now() + (liveTimeSec * 1000);
+const expire = Date.now() + liveTimeSec * 1000;
 payload.expire = expire;
 payload.iat = new Date().toISOString();
 

package/scripts/kill-port.js

@@ -15,7 +15,7 @@ if (!port) {
   process.exit(1);
 }
 
-async function killProcessOnPort (portNumber) {
+async function killProcessOnPort(portNumber) {
   const isWindows = process.platform === 'win32';
 
   console.log(`Searching for process on port ${portNumber}...`);
@@ -75,7 +75,10 @@ async function killProcessOnPort (portNumber) {
           return;
         }
 
-        const pids = stdout.trim().split('\n').filter(pid => pid);
+        const pids = stdout
+          .trim()
+          .split('\n')
+          .filter((pid) => pid);
 
         for (const pid of pids) {
           try {

package/scripts/npm/run.js

@@ -1,8 +1,7 @@
-
 import { spawn } from 'child_process';
 import os from 'os';
 
-function runScript (command, args) {
+function runScript(command, args) {
   const process = spawn(command, args);
 
   process.stdout.on('data', (data) => {

package/scripts/remove-nul.js

@@ -35,7 +35,7 @@ if (fs.existsSync(nulFile)) {
 // Also check for other common accidental files on Windows
 const accidentalFiles = ['nul', 'NUL', 'con', 'CON', 'aux', 'AUX', 'prn', 'PRN'];
 
-accidentalFiles.forEach(fileName => {
+accidentalFiles.forEach((fileName) => {
   const filePath = path.join(projectRoot, fileName);
   if (fs.existsSync(filePath)) {
     try {

package/scripts/update-sdk.js

@@ -18,41 +18,57 @@ const targets = [
 
 // A folder containing a direct file named `pin` is preserved untouched —
 // it is neither deleted nor overwritten with new content from the template.
-function findPinnedFolders (rootDir) {
+function findPinnedFolders(rootDir) {
   const pinned = new Set();
-  if (!existsSync(rootDir)) {return pinned;}
+  if (!existsSync(rootDir)) {
+    return pinned;
+  }
   const walk = (currentDir) => {
     const entries = readdirSync(currentDir, { withFileTypes: true });
     if (entries.some((e) => e.isFile() && e.name === 'pin')) {
       const rel = relative(rootDir, currentDir);
-      if (rel) {pinned.add(rel);}
+      if (rel) {
+        pinned.add(rel);
+      }
       return;
     }
     for (const entry of entries) {
-      if (entry.isDirectory()) {walk(join(currentDir, entry.name));}
+      if (entry.isDirectory()) {
+        walk(join(currentDir, entry.name));
+      }
     }
   };
   walk(rootDir);
   return pinned;
 }
 
-function isInsidePinned (relPath, pinned) {
-  if (!relPath) {return false;}
-  if (pinned.has(relPath)) {return true;}
+function isInsidePinned(relPath, pinned) {
+  if (!relPath) {
+    return false;
+  }
+  if (pinned.has(relPath)) {
+    return true;
+  }
   for (const p of pinned) {
-    if (relPath.startsWith(p + sep)) {return true;}
+    if (relPath.startsWith(p + sep)) {
+      return true;
+    }
   }
   return false;
 }
 
-function cleanExceptPinned (rootDir, pinned) {
-  if (!existsSync(rootDir)) {return;}
+function cleanExceptPinned(rootDir, pinned) {
+  if (!existsSync(rootDir)) {
+    return;
+  }
   const walk = (currentDir) => {
     const entries = readdirSync(currentDir, { withFileTypes: true });
     for (const entry of entries) {
       const full = join(currentDir, entry.name);
       const fullRel = relative(rootDir, full);
-      if (pinned.has(fullRel)) {continue;}
+      if (pinned.has(fullRel)) {
+        continue;
+      }
       const hasPinnedDescendant = [...pinned].some((p) => p.startsWith(fullRel + sep));
       if (entry.isDirectory() && hasPinnedDescendant) {
         walk(full);
@@ -72,7 +88,9 @@ for (const { name, src, dest, preserve = [], respectPin = false } of targets) {
   const saved = {};
   for (const file of preserve) {
     const p = join(dest, file);
-    if (existsSync(p)) {saved[file] = readFileSync(p);}
+    if (existsSync(p)) {
+      saved[file] = readFileSync(p);
+    }
   }
 
   const pinned = respectPin ? findPinnedFolders(dest) : new Set();
@@ -88,10 +106,14 @@ for (const { name, src, dest, preserve = [], respectPin = false } of targets) {
   cpSync(src, dest, {
     recursive: true,
     filter: (srcPath) => {
-      if (preserve.includes(basename(srcPath))) {return false;}
+      if (preserve.includes(basename(srcPath))) {
+        return false;
+      }
       if (respectPin && pinned.size > 0) {
         const rel = relative(src, srcPath);
-        if (isInsidePinned(rel, pinned)) {return false;}
+        if (isInsidePinned(rel, pinned)) {
+          return false;
+        }
       }
       return true;
     },

package/src/template/api/router.ts

@@ -29,7 +29,7 @@ export class ExampleController {
    */
   @Get('example')
   @Tags('Example')
-  public async getExample (): Promise<ExampleResponse> {
+  public async getExample(): Promise<ExampleResponse> {
     try {
       logger.info('Example endpoint called');
 
@@ -40,7 +40,7 @@ export class ExampleController {
       };
     } catch (error) {
       logger.error('Error in example endpoint:', error);
-      throw new Error(error instanceof Error ? error.message : 'Unknown error');
+      throw new Error(error instanceof Error ? error.message : 'Unknown error', { cause: error });
     }
   }
 
@@ -50,7 +50,7 @@ export class ExampleController {
    */
   @Get('health')
   @Tags('Server')
-  public async getHealth (): Promise<{
+  public async getHealth(): Promise<{
     status: string;
     timestamp: string;
     version: string;

package/src/template/prompts/agent-brief.ts

@@ -5,4 +5,3 @@
  */
 
 export const AGENT_BRIEF = 'Agent brief';
-

package/src/template/start.ts

@@ -46,23 +46,18 @@ const startProject = async (): Promise<void> => {
       if (!agent?.dev?.host || !agent?.prd?.host) {
         return '--consul-ui-not-configured--';
       }
-      return `${isConsulProd
-        ? `https://${agent.prd.host}/ui/${agent.prd.dc}`
-        : `https://${agent.dev.host}/ui/${agent.dev.dc}`
-      }/services/${serviceId}/instances`;
+      return `${isConsulProd ? `https://${agent.prd.host}/ui/${agent.prd.dc}` : `https://${agent.dev.host}/ui/${agent.dev.dc}`}/services/${serviceId}/instances`;
     },
 
     // Custom startup diagnostic info displayed in the console at server start
-    customStartupInfo: [
-      ['Custom param', 'any value'],
-    ],
+    customStartupInfo: [['Custom param', 'any value']],
   };
 
   // Start MCP server with assembled data
   await initMcpServer(serverData);
 };
 
-startProject().catch(error => {
+startProject().catch((error) => {
   console.error('Failed to start project:', error);
   process.exit(1);
 });

package/src/template/tools/handle-tool-call.ts

@@ -8,7 +8,7 @@ const logger = lgr.getSubLogger({ name: chalk.bgGrey('tools') });
  * Template tool handler - customize this for your specific tools
  * This handles MCP tool execution requests
  */
-export const handleToolCall = async (params: { name: string, arguments?: any }): Promise<any> => {
+export const handleToolCall = async (params: { name: string; arguments?: any }): Promise<any> => {
   const { name, arguments: args } = params;
 
   logger.info(`Tool called: ${name}`);
@@ -33,7 +33,7 @@ export const handleToolCall = async (params: { name: string, arguments?: any }):
  * Example tool implementation
  * Replace this with your actual tool logic
  */
-async function handleExampleTool (args: any): Promise<string> {
+async function handleExampleTool(args: any): Promise<string> {
   const { query } = args || {};
 
   if (!query) {
@@ -41,7 +41,7 @@ async function handleExampleTool (args: any): Promise<string> {
   }
 
   // Simulate some work
-  await new Promise(resolve => setTimeout(resolve, 100));
+  await new Promise((resolve) => setTimeout(resolve, 100));
 
   const result = {
     message: `Processed query: ${query}`,

package/src/template/tools/tools.ts

@@ -7,11 +7,7 @@ import { IToolInputSchema, IToolProperties } from '../../core/index.js';
  * Define your tools according to your server's functionality
  */
 
-
-const getGenericInputSchema = (
-  queryDescription?: string,
-  additionalProperties?: IToolProperties,
-): IToolInputSchema => {
+const getGenericInputSchema = (queryDescription?: string, additionalProperties?: IToolProperties): IToolInputSchema => {
   const properties = {
     query: {
       type: 'string',
@@ -80,10 +76,10 @@ export const tools: Tool[] = [
 
 // Helper to get tool by name
 export const getToolByName = (name: string): Tool | undefined => {
-  return tools.find(tool => tool.name === name);
+  return tools.find((tool) => tool.name === name);
 };
 
 // Helper to get all tool names
 export const getToolNames = (): string[] => {
-  return tools.map(tool => tool.name);
+  return tools.map((tool) => tool.name);
 };

package/src/tests/jest-simple-reporter.js

@@ -1,5 +1,5 @@
 export default class SimpleReporter {
-  onRunComplete (contexts, runResults) {
+  onRunComplete(contexts, runResults) {
     const { numPassedTests, numFailedTests, numPendingTests } = runResults;
     const total = numPassedTests + numFailedTests + numPendingTests;
     const actualSuccess = numFailedTests === 0 && total > 0;