fa-mcp-sdk 0.2.203 → 0.2.206

package/bin/fa-mcp.js

@@ -142,12 +142,12 @@ const removeIfExists = async (targetPath, relPath, options = {}) => {
         finalOptions = { ...finalOptions, recursive: true };
       }
     } catch {
-      // lstat упадёт, если файла/папки нет — это ок, просто пойдем в rm с теми же опциями
+      // lstat will crash if there is no file/folder – that's ok, just go to rm with the same options
     }
 
     await fs.rm(fullPath, finalOptions);
   } catch {
-    // игнорируем любые ошибки удаления
+    // ignore any deletion errors
   }
 };
 
@@ -835,7 +835,7 @@ certificate's public and private keys`,
   async replaceTemplateParameters (config) {
     const targetPath = config.projectAbsPath;
     const files = await this.getAllFiles(targetPath, ALLOWED_FILES);
-    const importRe = /'[^']+\/core\/index.js'/;
+    const importRe = /'[^']+\/core\/index.js'/ig;
     for (const filePath of files) {
       let content = await fs.readFile(filePath, 'utf8');
       let modified = false;

package/cli-template/.claude/hooks/eslint-fix.cjs

@@ -0,0 +1,100 @@
+#!/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();

package/cli-template/.claude/settings.json

@@ -28,6 +28,19 @@
     "DISABLE_COST_WARNINGS": "0",
     "DISABLE_TELEMETRY": "0"
   },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/eslint-fix.cjs"
+          }
+        ]
+      }
+    ]
+  },
   "hasCompletedOnboarding": true,
   "hasTrustDialogAccepted": true,
   "hasCompletedProjectOnboarding": true,

package/cli-template/FA-MCP-SDK-DOC/00-FA-MCP-SDK-index.md

@@ -2,11 +2,15 @@
 
 ## Overview
 
-The FA-MCP-SDK is a comprehensive TypeScript framework for building Model Context Protocol (MCP) servers. This is the documentation index - read the relevant sections based on your task.
+The FA-MCP-SDK is a comprehensive TypeScript framework for building Model Context 
+Protocol (MCP) servers. This is the documentation index - read the relevant 
+sections based on your task.
 
 ## Using with Claude Code
 
-This project includes a specialized agent `.claude/agents/fa-mcp-sdk.md` for Claude Code. The agent automatically reads relevant documentation sections and follows SDK patterns.
+This project includes a specialized agent `.claude/agents/fa-mcp-sdk.md` for 
+Claude Code. The agent automatically reads relevant documentation sections and 
+follows SDK patterns.
 
 ### Example Prompts
 
@@ -39,7 +43,8 @@ Use the fa-mcp-sdk subagent to create an MCP server for managing TODO lists with
 - REST API for web client
 ```
 
-The agent will read the appropriate documentation files and implement the functionality following SDK conventions.
+The agent will read the appropriate documentation files and implement the 
+functionality following SDK conventions.
 
 ## Quick Start
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.2.203",
+  "version": "0.2.206",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",

package/src/template/_types_/custom-config.ts

@@ -1,45 +1,45 @@
 /**
- * Пример расширения конфигурации fa-mcp-sdk кастомным блоком настроек.
+ * An example of extending the fa-mcp-sdk configuration with a custom settings block.
  *
- * Этот файл демонстрирует, как добавить собственные настройки
- * (например, для проверки членства пользователя в AD-группе).
+ * This file demonstrates how to add your own settings
+ * (for example, to check the user's membership in an AEC group).
  */
 
 import { AppConfig } from '../../core/index.js';
 
 /**
- * Настройки проверки членства в AD-группе
+ * AD Group Membership Verification Settings
  */
 export interface IGroupAccessConfig {
   groupAccess: {
-    /** AD-группа, членство в которой требуется для доступа */
+    /** AD Group whose membership is required for access */
     requiredGroup: string;
 
-    /** Опционально: разрешить доступ без проверки группы (для отладки) */
+    /** Optional: Allow access without checking the group (for debugging) */
     bypassGroupCheck?: boolean;
 
-    /** Опционально: кэшировать результат проверки (секунды) */
+    /** Optional: cache the result of the check (seconds) */
     cacheTtlSeconds?: number;
 
-    /** Опционально: список групп с разными уровнями доступа */
+    /** Optional: List of groups with different access levels */
     accessLevels?: {
-      /** Группа для полного доступа (read/write) */
+      /** Full access group (read/write) */
       fullAccess?: string;
-      /** Группа только для чтения */
+      /** Read-only group */
       readOnly?: string;
-      /** Группа администраторов */
+      /** Administrators group */
       admin?: string;
     };
   };
 }
 
 /**
- * Расширенный конфиг приложения с настройками проверки групп
+ * Extended app config with group checking settings
  */
 export interface CustomAppConfig extends AppConfig, IGroupAccessConfig {}
 
 // ========================================================================
-// ПРИМЕР YAML-КОНФИГУРАЦИИ (config/default.yaml)
+// YAML CONFIGURATION EXAMPLE (config/default.yaml)
 // ========================================================================
 /*
 groupAccess:
@@ -53,18 +53,18 @@ groupAccess:
 */
 
 // ========================================================================
-// ПРИМЕР ИСПОЛЬЗОВАНИЯ В КОДЕ
+// EXAMPLE OF USE IN CODE
 // ========================================================================
 /*
 import { appConfig } from '../core/index.js';
 
-// Типизированный доступ к кастомным настройкам
+// TYPED ACCESS TO CUSTOM SETTINGS
 const config = appConfig as CustomAppConfig;
 
 const requiredGroup = config.groupAccess.requiredGroup;
 const shouldBypass = config.groupAccess.bypassGroupCheck;
 
-// Проверка уровня доступа из payload
+// Checking the Access Level from Payload
 function getUserAccessLevel(payload: { user: string; groups?: string[] }): 'admin' | 'full' | 'readonly' | 'none' {
   const { accessLevels } = config.groupAccess;
   const userGroups = payload.groups || [];