docs: Update PROJECT-MASTER-INDEX with Agent Registry changes

- Added Agent Registry section (Single Source of Truth)
- Updated agent list (11 top-level + 2 internal)
- Added CLI tools documentation
- Fixed agent roles (DRUID = Ayurveda/Cosmetics R&D)
- Added YAROMIR and SOUL agents
- Updated architecture diagram reference
- Marked old issues as resolved

Co-authored-by: Cursor <cursoragent@cursor.com>

PROJECT-MASTER-INDEX.md

@@ -1,6 +1,6 @@
 # 📚 MASTER INDEX — MicroDAO / DAARION / DAGI
 
-**Оновлено:** 2026-01-28  
+**Оновлено:** 2026-01-29  
 **Призначення:** Єдина точка входу до всієї документації проекту
 
 ---
@@ -28,19 +28,61 @@
 
 ---
 
-## 🤖 Агенти Telegram (повний перелік)
+## 🎯 AGENT REGISTRY (Single Source of Truth)
 
-| Агент | ID | Токен | Статус | Промпт |
+**Дата впровадження:** 2026-01-29
-|-------|-----|-------|--------|--------|
+
-| **Helion** | helion | `8112062582:AAGS-...` | ✅ Active | `helion_prompt.txt` |
+### Canonical Source
-| **NUTRA** | nutra | `8517315428:AAGT-...` | ✅ Active | `nutra_prompt.txt` |
+
-| **AgroMatrix** | agromatrix | `8580290441:AAFu-...` | ✅ Active | `agromatrix_prompt.txt` |
+```
-| **Alateya** | alateya | `8436880945:AAEi-...` | ✅ Configured | `alateya_prompt.txt` |
+config/agent_registry.yml  ←── ЄДИНЕ ДЖЕРЕЛО ІСТИНИ
-| **CLAN (Spirit)** | clan | `8516872152:AAHH-...` | ✅ Configured | `clan_prompt.txt` |
+         │
-| **EONARCH** | eonarch | `7962391584:AAFY-...` | ✅ Configured | `eonarch_prompt.txt` |
+         │  python3 tools/agents generate
-| DAARWIZZ | daarwizz | - | - | `daarwizz_prompt.txt` |
+         ▼
-| Druid | druid | - | - | `druid_prompt.txt` |
+┌────────────────────────────────────────────────────────┐
-| GreenFood | greenfood | - | - | `greenfood_prompt.txt` |
+│ Generated configs (НЕ редагувати вручну!)              │
+│                                                        │
+│ • gateway-bot/agent_registry.json  → Gateway          │
+│ • config/router_agents.json        → Router           │
+│ • config/crewai_agents.json        → CrewAI           │
+└────────────────────────────────────────────────────────┘
+```
+
+### CLI інструменти
+
+```bash
+python3 tools/agents list      # Список агентів
+python3 tools/agents validate  # Валідація (для CI)
+python3 tools/agents generate  # Генерація конфігів
+python3 tools/agents smoke --id <agent_id>  # Smoke test
+```
+
+---
+
+## 🤖 Агенти (повний перелік)
+
+### TOP-LEVEL (User-facing, 11 agents)
+
+| Агент | ID | Роль | Telegram | Visibility |
+|-------|-----|------|----------|------------|
+| **DAARWIZZ** | daarwizz | Meta-Orchestrator & Digital Mayor | public | public |
+| **Helion** | helion | Energy Research Lead (Energy Union) | public | public |
+| **Aletheia** | alateya | Interdisciplinary Research & Lab OS | public | public |
+| **DRUID** | druid | **Ayurveda & Cosmetics R&D** | public | public |
+| **NUTRA** | nutra | Nutraceutical Research | public | public |
+| **Степан Матрікс** | agromatrix | AgroMatrix Platform | public | public |
+| **GREENFOOD** | greenfood | AI-ERP for Craft Food | public | public |
+| **CLAN** | clan | Spirit of Community | public | public |
+| **EONARCH** | eonarch | Consciousness Evolution Guide | public | public |
+| **YAROMIR** | yaromir | Private Tech Lead | whitelist | private |
+| **SOUL** | soul | Spiritual Mentor | public | public |
+
+### INTERNAL (Service agents, 2 agents)
+
+| Агент | ID | Роль | Scope |
+|-------|-----|------|-------|
+| **MONITOR** | monitor | Node Observability & Alerts | node_local |
+| **DevTools** | devtools | Development Tools | global |
 
 **Webhook URL формат:** `https://gateway.daarion.city/{agent_id}/telegram/webhook`
 
@@ -52,10 +94,13 @@
 
 | Документ | Шлях | Опис |
 |----------|------|------|
-| INFRASTRUCTURE.md | `/github-projects/microdao-daarion/docs/` | Порти, сервіси, конфігурація |
+| **NODA1-AGENT-ARCHITECTURE.md** | `docs/` | **Повна схема підключення агентів** |
-| infrastructure_quick_ref.ipynb | `/github-projects/microdao-daarion/docs/` | Швидка довідка |
+| **agent_registry.yml** | `config/` | **Canonical Source of Truth для агентів** |
-| NODA1-CURRENT-STATUS-2026-01-26.md | `/github-projects/microdao-daarion/` | Поточний статус NODA1 |
+| **README.md (config)** | `config/` | Як додавати нових агентів |
-| NODA1-V2-DEPLOYMENT.md | `/github-projects/microdao-daarion/` | Детальний deployment report |
+| INFRASTRUCTURE.md | `docs/` | Порти, сервіси, конфігурація |
+| infrastructure_quick_ref.ipynb | `docs/` | Швидка довідка |
+| NODA1-CURRENT-STATUS-2026-01-26.md | `/` | Поточний статус NODA1 |
+| NODA1-V2-DEPLOYMENT.md | `/` | Детальний deployment report |
 
 ### Memory та Qdrant
 
@@ -115,48 +160,75 @@
 
 ---
 
+## 🛠️ Зміни 2026-01-29
+
+### ✅ UNIFIED AGENT REGISTRY (Major Update)
+
+**Commits:**
+- `1c80cef` - feat: Unified Agent Registry - Single Source of Truth
+- `c627d8c` - feat: Agent Registry runtime integration on NODA1
+
+**Що зроблено:**
+
+1. **Canonical Source of Truth** (`config/agent_registry.yml`)
+   - 13 агентів (11 top-level + 2 internal)
+   - Єдине місце для всіх конфігурацій
+   - Feature flag `AGENT_REGISTRY_ENABLED=true`
+
+2. **CLI інструменти** (`tools/agents`)
+   - `list` - список агентів
+   - `validate` - валідація для CI
+   - `generate` - генерація конфігів
+   - `smoke --id <agent>` - smoke test
+
+3. **Runtime інтеграція:**
+   - Gateway: `registry_loader.py` → `agent_registry.json`
+   - Router: `registry_loader.py` → `router_agents.json`
+   - CrewAI: `registry_loader.py` → `crewai_agents.json`
+
+4. **Нові агенти:**
+   - **YAROMIR** - Private Tech Lead (whitelist access)
+   - **SOUL** - Spiritual Mentor
+
+5. **Виправлені ролі:**
+   - **DRUID** → Ayurveda & Cosmetics R&D (не "Knowledge Search")
+   - **CLAN** → Spirit of Community (не "Community Manager")
+
+6. **Документація:**
+   - `docs/NODA1-AGENT-ARCHITECTURE.md` - повна схема
+   - `config/README.md` - як додавати агентів
+
+### Як додати нового агента
+
+```bash
+# 1. Редагувати registry
+nano config/agent_registry.yml
+
+# 2. Створити prompt файл
+touch gateway-bot/new_agent_prompt.txt
+
+# 3. Валідувати
+python3 tools/agents validate
+
+# 4. Згенерувати конфіги
+python3 tools/agents generate
+
+# 5. Smoke test
+python3 tools/agents smoke --id new_agent
+
+# 6. Restart gateway
+docker restart dagi-gateway-node1
+```
+
+---
+
 ## 🛠️ Зміни 2026-01-28
 
 ### Додано нових агентів
 
-1. **Alateya** — R&D, біотех, інновації
+1. **Alateya** — R&D, біотех, інновації (з CrewAI командою "професорів")
-   - Токен: `8436880945:AAEi-HS6GEctddoqBUd37MHfweZQP-OjRlo`
-   - Конфіг додано в `http_api.py` ✅
-   - Токен додано в `docker-compose.node1.yml` ✅
-
 2. **CLAN (Spirit)** — Дух Общини
-   - Токен: `8516872152:AAHH26wU8hJZJbSCJXb4vbmPmakTP77ok5E`
-   - Промпт: `clan_prompt.txt` ✅
-   - Конфіг додано в `http_api.py` ✅
-   - Токен додано в `docker-compose.node1.yml` ✅
-
 3. **EONARCH** — Еволюція свідомості
-   - Токен: `7962391584:AAFYkelLRG3VR_Lxuu6pEGG76t4vZdANtz4`
-   - Промпт: `eonarch_prompt.txt` ✅
-   - Конфіг додано в `http_api.py` ✅
-   - Токен додано в `docker-compose.node1.yml` ✅
-
-### Що потрібно зробити для активації
-
-```bash
-# 1. На NODA1 — оновити код
-cd /opt/microdao-daarion
-git pull
-
-# 2. Перебудувати gateway
-docker-compose -f docker-compose.node1.yml build gateway
-
-# 3. Перезапустити gateway
-docker-compose -f docker-compose.node1.yml up -d gateway
-
-# 4. Встановити webhooks для нових ботів
-curl -X POST "https://api.telegram.org/bot8436880945:AAEi-HS6GEctddoqBUd37MHfweZQP-OjRlo/setWebhook?url=https://gateway.daarion.city/alateya/telegram/webhook"
-curl -X POST "https://api.telegram.org/bot8516872152:AAHH26wU8hJZJbSCJXb4vbmPmakTP77ok5E/setWebhook?url=https://gateway.daarion.city/clan/telegram/webhook"
-curl -X POST "https://api.telegram.org/bot7962391584:AAFYkelLRG3VR_Lxuu6pEGG76t4vZdANtz4/setWebhook?url=https://gateway.daarion.city/eonarch/telegram/webhook"
-
-# 5. Перевірити
-curl https://gateway.daarion.city/health
-```
 
 ---
 
@@ -189,11 +261,26 @@ curl -s http://144.76.224.179:6333/collections | jq '.result.collections[] | {na
 
 ## ⚠️ Відомі проблеми
 
-1. **gateway → router: "All connection attempts failed"** — потрібно перевірити мережу
+1. ~~**gateway → router: "All connection attempts failed"**~~ — ✅ Виправлено (router підключено до dagi-network)
-2. **Alateya токен не був раніше доданий** — виправлено сьогодні
+2. ~~**Alateya токен не був раніше доданий**~~ — ✅ Виправлено
-3. **Clan, Eonarch не були в production репо** — додано сьогодні
+3. ~~**Clan, Eonarch не були в production репо**~~ — ✅ Виправлено
+4. ~~**Розбіжності в ролях агентів між Gateway/Router/CrewAI**~~ — ✅ Виправлено (Unified Registry)
+
+---
+
+## 📊 Схема підключення (спрощена)
+
+```
+TELEGRAM → GATEWAY:9300 → ROUTER:8000 → LLM (Ollama/DeepSeek)
+                ↓              ↓
+           Memory:8000    CrewAI:9010
+                ↓
+        Qdrant + Neo4j + Postgres
+```
+
+Повна схема: `docs/NODA1-AGENT-ARCHITECTURE.md`
 
 ---
 
 **Автор:** Cursor Agent  
-**Останнє оновлення:** 2026-01-28
+**Останнє оновлення:** 2026-01-29