@vint.tri/report_gen_mcp 1.7.25 → 1.7.27

package/NEURAL_NETWORK_FINAL_FIX_SUMMARY.md

@@ -52,12 +52,55 @@
 3. **`NEURAL_NETWORK_IMAGE_INTEGRATION_FIX_SUMMARY.md`** - Предыдущее исправление интеграции изображений
 4. **`NEURAL_NETWORK_INSTRUCTIONS_v1.7.1.md`** - Обновленные основные инструкции
 
+## ✅ ПРОВЕРКА НА ПРОТИВОРЕЧИЯ
+
+После тщательной проверки всех инструкций подтверждено отсутствие противоречий:
+
+### 🔍 АНАЛИЗ СООТВЕТСТВИЯ
+
+1. **`NEURAL_NETWORK_INSTRUCTIONS_v1.7.1.md`** - Основные инструкции:
+   - ✅ Требует `"type"` и `"config"` для всех элементов
+   - ✅ Поддерживает `"type": "url"` для локальных файлов
+   - ✅ Требует `file://` префикс для локальных путей
+   - ✅ Запрещает использование `"image"` как типа
+
+2. **`NEURAL_NETWORK_EMERGENCY_FIX.md`** - Аварийные инструкции:
+   - ✅ Поддерживает и дополняет основные инструкции
+   - ✅ Четко запрещает `"image"` и `"path"` поля
+   - ✅ Требует `"type": "url"` и `"config"` структуру
+   - ✅ Требует `file://` префикс для путей
+
+3. **`NEURAL_NETWORK_IMAGE_INTEGRATION_FIX_SUMMARY.md`** - Историческое исправление:
+   - ✅ Совместимо с текущими инструкциями
+   - ✅ Поддерживает те же форматы элементов
+   - ✅ Не противоречит аварийным инструкциям
+
+### 🔄 ЕДИНЫЙ СТАНДАРТ ФОРМАТА
+
+Все инструкции согласованы по единому стандарту:
+```json
+{
+  "elements": {
+    "element_key": {
+      "type": "url",           // ✅ Единый тип для всех изображений
+      "config": {              // ✅ Обязательный объект конфигурации
+        "url": "file:///path", // ✅ file:// префикс для локальных файлов
+        "alt": "Описание",     // ✅ Альтернативный текст
+        "width": 512,          // ✅ Ширина (опционально)
+        "height": 512          // ✅ Высота (опционально)
+      }
+    }
+  }
+}
+```
+
 ## ✅ ПРОВЕРКА РАБОТЫ
 Тесты подтверждают, что:
 - ❌ Старый формат больше не работает
 - ✅ Новый формат проходит валидацию успешно
 - 🔄 Автоматическая конвертация работает корректно
 - 📝 Инструкции четко объясняют правильный формат
+- 🆕 Все инструкции согласованы и не противоречат друг другу
 
 ## 🎉 РЕЗУЛЬТАТ
 Нейросеть теперь может правильно генерировать отчеты с изображениями без ошибок валидации параметров. Все форматы соответствуют требованиям инструмента `generate-report`.

package/NEURAL_NETWORK_INSTRUCTIONS.md

@@ -110,7 +110,7 @@
 
 Обязательно покажите пользователю содержимое файла, чтобы он мог сразу ознакомиться с результатом без необходимости открывать файл отдельно.
 
-**ВАЖНОЕ ТРЕБОВАНИЕ**: Отчет должен быть максимально красивым и качественным. Содержать изображения, графики, выводы и рассуждения. Отчет должен быть строго в HTML формате!
+**ВАЖНОЕ ТРЕБОВАНИЕ**: Отчет должен быть максимально красивым и качественным. Содержать **как минимум одну диаграмму и одно изображение**, а также выводы и рассуждения. Отчет должен быть строго в HTML формате!
 
 **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
 
@@ -677,28 +677,32 @@
 
 ### 3. ЧИСЛОВЫЕ ДАННЫЕ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
 
-❌ НЕПРАВИЛЬНО:
+❌ НЕПРАВИЛЬНО (это вызовет ошибку валидации):
 ```json
 "data": 10
 ```
 
-✅ ПРАВИЛЬНО:
+✅ ПРАВИЛЬНО (даже для одного значения):
 ```json
 "data": [10]
 ```
 
+**КРИТИЧЕСКИ ВАЖНО:** Всегда оборачивайте числовые данные для диаграмм в массив. Хотя система теперь пытается исправлять некоторые ошибки, правильный формат гарантирует стабильную работу.
+
 ### 4. ТЕКСТОВЫЕ МЕТКИ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
 
-❌ НЕПРАВИЛЬНО:
+❌ НЕПРАВИЛЬНО (это вызовет ошибку валидации):
 ```json
 "labels": "Январь"
 ```
 
-✅ ПРАВИЛЬНО:
+✅ ПРАВИЛЬНО (даже для одной метки):
 ```json
 "labels": ["Январь"]
 ```
 
+**КРИТИЧЕСКИ ВАЖНО:** Всегда оборачивайте текстовые метки для диаграмм в массив. Хотя система теперь пытается исправлять некоторые ошибки, правильный формат гарантирует стабильную работу.
+
 ### 5. ЗНАЧЕНИЕ options.title ДОЛЖНО БЫТЬ СТРОКОЙ!
 
 ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
@@ -1013,7 +1017,7 @@
 1. Всегда проверяйте успешность выполнения каждой операции перед переходом к следующему шагу
 2. Если какой-либо шаг завершается ошибкой, сообщите пользователю об этом и предложите решение
 3. Убедитесь, что все пути к файлам корректны и файлы действительно существуют
-4. При работе с Claude Desktop используйте параметр `tempDirectory` при генерации отчетов для избежания проблем с правами доступа
+4. **Сохранение файлов**: Все отчеты автоматически сохраняются в системную временную директорию. Вам не нужно указывать путь, просто передайте имя файла в `outputFile`. Инструмент вернет полный путь к сохраненному файлу.
 5. Создавайте отчеты с красивым оформлением, используя заголовки, списки и другие элементы форматирования
 6. Добавляйте в отчеты диаграммы и изображения для лучшей визуализации данных
 7. Всегда после генерации отчета возвращайте пользователю ссылку на файл отчета, путь к файлу отчета и содержимое файла

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.7.25"
+        version: "1.7.27"
     }, {
         // Disable health check to prevent automatic calls
         capabilities: {

package/dist/utils/reportGenerator.d.ts

@@ -16,7 +16,7 @@ interface PollinationsImageElement {
 }
 type ImageElement = UrlImageElement | PollinationsImageElement;
 type ReportElement = ChartElement | ImageElement;
-export declare function generateReport(document: string, elements: Record<string, ReportElement>, outputFile: string): Promise<{
+export declare function generateReport(document: string, elements: Record<string, ReportElement>, outputFile: string, tempDirectory?: string): Promise<{
     success: boolean;
     filePath: string;
 }>;

package/dist/utils/reportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/reportGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,cAAc,EAAkB,MAAM,wBAAwB,CAAC;AAGxE,KAAK,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAI7E,UAAU,YAAY;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;CACb;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC;CACb;AAED,KAAK,YAAY,GAAG,eAAe,GAAG,wBAAwB,CAAC;AAC/D,KAAK,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AAqDjD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,UAAU,EAAE,MAAM;;;GA+HnB"}
+{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/reportGenerator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,cAAc,EAAkB,MAAM,wBAAwB,CAAC;AAGxE,KAAK,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAI7E,UAAU,YAAY;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;CACb;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC;CACb;AAED,KAAK,YAAY,GAAG,eAAe,GAAG,wBAAwB,CAAC;AAC/D,KAAK,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AA+DjD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM;;;GAmIvB"}

package/dist/utils/reportGenerator.js

@@ -1,4 +1,6 @@
 import fs from 'fs-extra';
+import os from 'os';
+import path from 'path';
 import ejs from 'ejs';
 import { marked } from 'marked';
 import { barSchema, renderBarChart } from '../charts/bar.js';
@@ -30,6 +32,10 @@ function normalizeChartConfig(config) {
         return config;
     }
     const normalizedConfig = { ...config };
+    // Normalize labels
+    if (normalizedConfig.labels && typeof normalizedConfig.labels === 'string') {
+        normalizedConfig.labels = [normalizedConfig.labels];
+    }
     // Normalize datasets
     if (normalizedConfig.datasets && Array.isArray(normalizedConfig.datasets)) {
         normalizedConfig.datasets = normalizedConfig.datasets.map((dataset) => {
@@ -44,12 +50,19 @@ function normalizeChartConfig(config) {
                     normalizedDataset[prop] = [normalizedDataset[prop]];
                 }
             }
+            // Normalize data
+            if (normalizedDataset.data && !Array.isArray(normalizedDataset.data)) {
+                normalizedDataset.data = [normalizedDataset.data];
+            }
             return normalizedDataset;
         });
     }
     return normalizedConfig;
 }
-export async function generateReport(document, elements, outputFile) {
+export async function generateReport(document, elements, outputFile, tempDirectory) {
+    const reportsDir = tempDirectory || process.env.REPORTS_DIR || os.tmpdir();
+    await fs.ensureDir(reportsDir);
+    const finalOutputFile = path.join(reportsDir, outputFile);
     // Validate elements
     for (const [id, element] of Object.entries(elements)) {
         if (element.type in chartRenderers) {
@@ -171,6 +184,6 @@ export async function generateReport(document, elements, outputFile) {
   `;
     const fullHtml = ejs.render(template, { htmlContent }, { escape: (str) => str });
     // Save to file
-    await fs.writeFile(outputFile, fullHtml);
-    return { success: true, filePath: outputFile };
+    await fs.writeFile(finalOutputFile, fullHtml);
+    return { success: true, filePath: finalOutputFile };
 }

package/package.json

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