docs: expand lint scope batch6 (2 files)

docs/AGENTS_TOOLS_AND_MONITORING_REPORT.md

@@ -7,7 +7,7 @@
 
 ### Поточний стан
 
-**❌ Інструменти пошуку НЕ налаштовані для агентів**
+### ❌ Інструменти пошуку НЕ налаштовані для агентів
 
 Перевірка показала:
 - CrewAI backend (`dagi-crewai`) не містить інструментів пошуку (SerperDevTool, DuckDuckGoSearchRun, тощо)
@@ -101,12 +101,12 @@
 
 ## 📊 DAGI Моніторинг
 
-### Поточний стан
+### Поточний стан моніторингу
 
 #### Prometheus
 - ✅ **Статус:** Healthy
 - ✅ **Порт:** 9090
-- ✅ **URL:** http://144.76.224.179:9090
+- ✅ **URL:** [http://144.76.224.179:9090](http://144.76.224.179:9090)
 - ⚠️ **Проблеми:** Деякі targets показують `down`:
   - `gateway` - down
   - `router` - down
@@ -116,7 +116,7 @@
 #### Grafana
 - ⚠️ **Статус:** Restarting (проблеми з плагіном neo4j-datasource)
 - ✅ **Порт:** 3000
-- ✅ **URL:** http://144.76.224.179:3000
+- ✅ **URL:** [http://144.76.224.179:3000](http://144.76.224.179:3000)
 - ⚠️ **Проблема:** Плагін `neo4j-datasource` не знайдено (404)
 
 ### Налаштовані метрики
@@ -138,7 +138,7 @@ Prometheus збирає метрики з:
 
 ### Чи відображаються зміни в реальному часі?
 
-**⚠️ Частково**
+### ⚠️ Частково
 
 **Проблеми:**
 1. Деякі сервіси не експортують метрики (`/metrics` endpoint)
@@ -160,17 +160,17 @@ Prometheus збирає метрики з:
 ## 🔗 Посилання для моніторингу
 
 ### Локальний доступ (на сервері)
-- **Prometheus:** http://localhost:9090
-- **Grafana:** http://localhost:3000
-- **Router Health:** http://localhost:9102/health
-- **Gateway Health:** http://localhost:9300/health
-- **Router Providers:** http://localhost:9102/providers
-- **Router Routing:** http://localhost:9102/routing
+- **Prometheus:** [http://localhost:9090](http://localhost:9090)
+- **Grafana:** [http://localhost:3000](http://localhost:3000)
+- **Router Health:** [http://localhost:9102/health](http://localhost:9102/health)
+- **Gateway Health:** [http://localhost:9300/health](http://localhost:9300/health)
+- **Router Providers:** [http://localhost:9102/providers](http://localhost:9102/providers)
+- **Router Routing:** [http://localhost:9102/routing](http://localhost:9102/routing)
 
 ### Публічний доступ
-- **Prometheus:** http://144.76.224.179:9090
-- **Grafana:** http://144.76.224.179:3000
-- **Gateway Health:** https://gateway.daarion.city/health
+- **Prometheus:** [http://144.76.224.179:9090](http://144.76.224.179:9090)
+- **Grafana:** [http://144.76.224.179:3000](http://144.76.224.179:3000)
+- **Gateway Health:** [https://gateway.daarion.city/health](https://gateway.daarion.city/health)
 
 ---
 
@@ -195,6 +195,3 @@ Prometheus збирає метрики з:
 
 **Останнє оновлення:** 2025-11-21  
 **Статус:** ⚠️ Потребує уваги (інструменти пошуку та моніторинг)
-
-
-

docs/FINAL_INTEGRATION_SUMMARY.md

@@ -26,7 +26,7 @@
 **Результат**: Боти читають PDF файли та відповідають на питання про них!
 
 **Приклад**:
-```
+```text
 Ти → 📄 whitepaper.pdf
 Бот → ✅ Документ 'whitepaper.pdf' оброблено.
       [Перші 500 символів тексту]...
@@ -47,7 +47,7 @@
 **Результат**: Боти відповідають голосом на голосові повідомлення!
 
 **Приклад**:
-```
+```text
 Ти → 🎤 [Голосове] "Привіт, як справи?"
 Бот → 🔊 [Голосове відповідь] "Привіт! У мене все добре..."
 ```
@@ -74,14 +74,14 @@
 6. Voice Responses (1h)
 7. Documents Processed (1h)
 
-**Доступ**: http://144.76.224.179:3000  
+**Доступ**: [http://144.76.224.179:3000](http://144.76.224.179:3000)  
 **Login**: admin / admin
 
 ---
 
 ## 📊 Статистика змін
 
-### Файли створені:
+### Файли створені
 1. `/telegram-gateway/app/voice_handler.py` - обробка voice та document
 2. `/monitoring/grafana/dashboards/daarion_services_overview.json`
 3. `/monitoring/grafana/dashboards/telegram_bots.json`
@@ -89,7 +89,7 @@
 5. `/docs/testing/VOICE_PHOTO_READY.md`
 6. `/docs/FINAL_INTEGRATION_SUMMARY.md`
 
-### Файли оновлені:
+### Файли оновлені
 1. `/telegram-gateway/app/telegram_listener.py`:
    - Додано `send_voice()` метод (+40 рядків)
    - Додано handlers для voice, document, photo
@@ -129,7 +129,7 @@
 3. (Поки що заглушка - чекаємо multimodal LLM)
 
 ### Моніторинг 📊
-1. Відкрити http://144.76.224.179:3000
+1. Відкрити [http://144.76.224.179:3000](http://144.76.224.179:3000)
 2. Login: admin / admin
 3. Вибрати Dashboard:
    - "DAARION Services Overview" - загальний моніторинг
@@ -139,21 +139,21 @@
 
 ## 🐛 Відомі обмеження
 
-### Vision Encoder:
+### Vision Encoder
 - ⚠️ Поточний Vision Encoder робить тільки **embeddings** (векторизацію)
 - ⚠️ Для опису зображень потрібен **multimodal LLM** (GPT-4V, Claude Vision, LLaVA)
 - 💡 **Рішення**: Інтегрувати OpenAI GPT-4V або Claude 3 Vision API
 
-### Parser Service:
+### Parser Service
 - ⚠️ Обмеження на розмір PDF (зазвичай < 50 MB)
 - ⚠️ Для дуже великих документів потрібен chunking
 
-### TTS:
+### TTS
 - ⚠️ Відповіді обмежені до 500 символів (gTTS обмеження)
 - ⚠️ Для довших відповідей треба streaming TTS або chunking
 - 💡 **Рішення**: Додати більш потужний TTS (Coqui TTS, ElevenLabs API)
 
-### Grafana:
+### Grafana
 - ⚠️ Деякі метрики можуть бути порожні якщо endpoints ще не викликалися
 - ⚠️ `/metrics` endpoint відсутній в деяких сервісах (STT, TTS, Parser)
 
@@ -161,35 +161,35 @@
 
 ## 🎯 Наступні кроки (опційно)
 
-### Priority 🔴 HIGH:
-1. **Multimodal LLM для Vision**:
+### Priority 🔴 HIGH
+1. **Multimodal LLM для Vision**
    - Інтегрувати GPT-4V або Claude 3 Vision
    - Додати endpoint `/analyze` в vision service
    - Тестування з різними типами зображень
 
-2. **Додати /metrics до всіх сервісів**:
+2. **Додати /metrics до всіх сервісів**
    - STT: додати prometheus_client
    - TTS: додати prometheus_client
    - Parser: додати prometheus_client
 
-### Priority 🟡 MEDIUM:
-3. **RAG Integration для документів**:
+### Priority 🟡 MEDIUM
+3. **RAG Integration для документів**
    - Інгест PDF в RAG після парсингу
    - Підтримка follow-up питань з контекстом
    - Зберігання історії документів
 
-4. **Streaming TTS**:
+4. **Streaming TTS**
    - Замінити gTTS на Coqui TTS або ElevenLabs
    - Підтримка довших відповідей
    - Кращ качість голосу
 
-### Priority 🟢 LOW:
-5. **Grafana Alerts**:
+### Priority 🟢 LOW
+5. **Grafana Alerts**
    - Налаштувати Alertmanager
    - Email/Telegram notifications
    - Custom alert rules
 
-6. **Extended Monitoring**:
+6. **Extended Monitoring**
    - Додати більше custom metrics
    - User analytics (кількість користувачів, активність)
    - LLM usage tracking (tokens, cost)
@@ -236,7 +236,7 @@
 
 ## 🏆 Підсумок
 
-### Що працює:
+### Що працює
 - ✅ Голосові повідомлення (STT) → Бот
 - ✅ Бот → Голосові відповіді (TTS)
 - ✅ PDF парсинг та Q&A
@@ -246,12 +246,12 @@
 - ✅ 3 боти (DAARWIZZ, Helion, GREENFOOD)
 - ✅ Автоматичне визначення reply_mode (voice/text)
 
-### Готовність:
+### Готовність
 - 🟢 **Production Ready**: Voice, TTS, Parser, Monitoring
 - 🟡 **Partial Ready**: Vision (потрібен multimodal LLM)
 - 🔴 **Not Ready**: RAG integration, Advanced alerts
 
-### Технічний стек:
+### Технічний стек
 - **Backend**: Python 3.11, FastAPI, asyncio, httpx
 - **Telegram**: aiogram 3.x, Local Telegram Bot API
 - **AI/ML**: Whisper (STT), gTTS (TTS), DotsOCR (Parser), DAGI Router
@@ -282,4 +282,3 @@
 *Автор: Assistant (via Cursor)*  
 *Версія: 1.0*  
 *Тривалість імплементації: ~2 години*
-

docs/standards/lint_scope.txt

@@ -35,6 +35,8 @@ docs/ACTION_PLAN.md
 docs/NODE2_GUARDIAN_SETUP.md
 docs/hardcode_vs_config.md
 docs/NODE2_DIAGNOSTIC_REPORT.md
+docs/FINAL_INTEGRATION_SUMMARY.md
+docs/AGENTS_TOOLS_AND_MONITORING_REPORT.md
 docs/consolidation/README.md
 docs/consolidation/SOURCES.md
 docs/runbooks/DOCS_SERVICES_AUTOMATION_RUNBOOK.md