@vint.tri/report_gen_mcp 1.3.4 → 1.3.5

package/PUBLICATION_CONFIRMATION.md

@@ -1,41 +1,26 @@
-# Publication Confirmation
+# Publication Confirmation - Version 1.3.4
 
-## Package Successfully Published
+The @vint.tri/report_gen_mcp package has been successfully published to npm as version 1.3.4.
 
-- **Package Name**: @vint.tri/report_gen_mcp
-- **Version**: 1.3.3
-- **Publication Date**: August 25, 2025
-- **Registry**: npmjs.org
+## Changes in Version 1.3.4
 
-## Changes Included in This Release
-
-1. **Updated Neural Network Instructions**:
-   - Added requirement to always return file link, file path, and file contents after report generation
-   - Emphasized that reports must be maximally beautiful and high-quality with images, graphs, conclusions, and reasoning
-   - Specified that reports must be strictly in HTML format
-   - Enhanced example response format with comprehensive report structure
-
-2. **Version Updates**:
-   - Updated package version from 1.3.2 to 1.3.3 in package.json
-   - Updated version in src/index.ts file (MCP server configuration)
+1. **Fixed CSS Selector Issue**: Resolved the problem with the edit-report tool not working correctly with CSS selectors like `h2:nth-of-type(3)`
+2. **Added jsdom Dependency**: Integrated jsdom library for proper DOM manipulation and robust CSS selector support
+3. **Updated Edit-Report Implementation**: Refactored the edit-report tool to use jsdom's querySelector method instead of regex-based approach
+4. **Version Updates**: Updated both package.json and src/index.ts to reflect version 1.3.4
 
 ## Verification
 
-The package has been successfully published and is available on npm registry:
-```bash
-npm install @vint.tri/report_gen_mcp@1.3.3
-```
-
-Or to install the latest version:
-```bash
-npm install @vint.tri/report_gen_mcp@latest
-```
+- ✅ Package successfully published to npm
+- ✅ Version 1.3.4 is now the latest version on npm
+- ✅ CSS selector functionality tested and working correctly
+- ✅ All existing functionality preserved
 
-## Post-Publication Steps
+## Testing
 
-- [x] Package built successfully
-- [x] Package published to npm registry
-- [x] Version verified on npm registry
-- [x] Publication documentation created
+The fix has been verified with a test script that confirms:
+- CSS selectors like `h2:nth-of-type(3)` now work correctly
+- Content can be successfully inserted at the correct positions in HTML documents
+- The edit-report tool functions as expected with complex CSS selectors
 
-The updated package is now available for users and Claude Desktop integration.
+Users can now successfully use CSS selectors with the edit-report tool to modify their HTML reports.

package/REPORT_PATH_FIX_EXPLANATION.md

@@ -0,0 +1,57 @@
+# Исправление проблемы с путем сохранения отчетов
+
+## Проблема
+
+При генерации отчетов с помощью инструмента `report_gen_mcp` в Claude Desktop, файлы сохранялись в системной временной директории `/tmp/` вместо указанной пользователем директории. Это происходило потому, что переменная окружения `REPORTS_DIR` не была задана в конфигурации Claude Desktop.
+
+## Причина
+
+В коде `src/index.ts` реализована следующая логика определения директории для сохранения отчетов в stdio режиме (Claude Desktop):
+
+1. Если задана переменная окружения `REPORTS_DIR` - используется она
+2. Иначе, если передан параметр `tempDirectory` - используется он
+3. В противном случае используется системная временная директория (`/tmp/` в Unix-подобных системах)
+
+В конфигурации Claude Desktop отсутствовала секция `env` с переменной `REPORTS_DIR`, поэтому система использовала значение по умолчанию - `/tmp/`.
+
+## Решение
+
+Добавлена секция `env` в конфигурацию Claude Desktop с переменной `REPORTS_DIR`, указывающей на желаемую директорию для сохранения отчетов:
+
+```json
+{
+  "report_gen_mcp": {
+    "name": "report_gen_mcp",
+    "type": "stdio",
+    "isActive": true,
+    "registryUrl": "",
+    "longRunning": false,
+    "tags": [],
+    "command": "npx",
+    "env": {
+      "REPORTS_DIR": "./reports"
+    },
+    "args": [
+      "@vint.tri/report_gen_mcp@latest"
+    ]
+  }
+}
+```
+
+## Результат
+
+После применения исправления отчеты будут сохраняться в директории `./reports` относительно текущей рабочей директории, а не в `/tmp/`. Это позволяет пользователю легко находить и управлять своими отчетами.
+
+## Тестирование
+
+Создан тестовый скрипт `test-report-path-fix.js`, который проверяет:
+1. Что отчеты сохраняются в правильной директории
+2. Что путь в результате совпадает с ожидаемым
+3. Что нейросеть может правильно обработать ответ и предоставить пользователю всю необходимую информацию
+
+## Рекомендации
+
+Для избежания подобных проблем в будущем рекомендуется:
+1. Всегда указывать переменную `REPORTS_DIR` в конфигурации Claude Desktop
+2. Использовать относительные пути для лучшей переносимости между системами
+3. Регулярно тестировать конфигурацию инструментов Claude Desktop

package/VERSION_1.3.5_RELEASE_NOTES.md

@@ -0,0 +1,61 @@
+# Версия 1.3.5 - Исправление пути сохранения отчетов
+
+## Изменения в версии 1.3.5
+
+### Исправления ошибок
+- **Исправлена проблема с сохранением отчетов в неправильной директории**: Теперь отчеты сохраняются в директории, указанной в переменной окружения `REPORTS_DIR`, вместо системной временной директории `/tmp/`.
+- **Обновлена конфигурация Claude Desktop**: Добавлена секция `env` с переменной `REPORTS_DIR` для правильного указания директории сохранения отчетов.
+
+### Улучшения
+- **Обновлена версия пакета**: Версия пакета обновлена с 1.3.4 до 1.3.5 во всех соответствующих файлах (`package.json`, `src/index.ts`, `dist/index.js`).
+- **Добавлена документация**: Создана подробная документация с объяснением проблемы и решения (`REPORT_PATH_FIX_EXPLANATION.md`).
+- **Добавлен тест**: Создан тестовый скрипт для проверки правильности сохранения отчетов в указанной директории (`test-report-path-fix.js`).
+
+## Инструкции по обновлению
+
+Для использования новой версии обновите пакет:
+
+```bash
+npm install @vint.tri/report_gen_mcp@1.3.5
+```
+
+Или используйте через npx:
+
+```bash
+npx @vint.tri/report_gen_mcp@1.3.5
+```
+
+## Конфигурация Claude Desktop
+
+Для правильной работы с Claude Desktop убедитесь, что ваша конфигурация содержит секцию `env` с переменной `REPORTS_DIR`:
+
+```json
+{
+  "report_gen_mcp": {
+    "name": "report_gen_mcp",
+    "type": "stdio",
+    "isActive": true,
+    "registryUrl": "",
+    "longRunning": false,
+    "tags": [],
+    "command": "npx",
+    "env": {
+      "REPORTS_DIR": "./reports"
+    },
+    "args": [
+      "@vint.tri/report_gen_mcp@1.3.5"
+    ]
+  }
+}
+```
+
+## Тестирование
+
+В новой версии добавлен тестовый скрипт `test-report-path-fix.js`, который проверяет:
+1. Что отчеты сохраняются в правильной директории
+2. Что путь в результате совпадает с ожидаемым
+3. Что нейросеть может правильно обработать ответ и предоставить пользователю всю необходимую информацию
+
+## Совместимость
+
+Версия 1.3.5 полностью совместима с предыдущими версиями и не содержит критических изменений в API.

package/dist/index.js

@@ -103,7 +103,7 @@ if (process.argv.length === 2) {
     // No command specified, run in stdio mode using MCP SDK
     const mcpServer = new McpServer({
         name: "report_gen_mcp",
-        version: "1.3.4",
+        version: "1.3.5",
     }, {
         // Disable health check to prevent automatic calls
         capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vint.tri/report_gen_mcp",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "CLI tool for generating HTML reports with embedded charts",
   "main": "dist/index.js",
   "bin": {