daarion-admin/microdao-daarion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 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>
This commit is contained in:
Apple
2026-01-29 09:47:21 -08:00
parent b9b7660930
commit 8f046e7226
1 changed files with 144 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

201
PROJECT-MASTER-INDEX.md
View File

@@ -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 | Токен | Статус | Промпт |
|-------|-----|-------|--------|--------|
| **Helion** | helion | `8112062582:AAGS-...` | ✅ Active | `helion_prompt.txt` |
| **NUTRA** | nutra | `8517315428:AAGT-...` | ✅ Active | `nutra_prompt.txt` |
| **AgroMatrix** | agromatrix | `8580290441:AAFu-...` | ✅ Active | `agromatrix_prompt.txt` |
| **Alateya** | alateya | `8436880945:AAEi-...` | ✅ Configured | `alateya_prompt.txt` |
| **CLAN (Spirit)** | clan | `8516872152:AAHH-...` | ✅ Configured | `clan_prompt.txt` |
| **EONARCH** | eonarch | `7962391584:AAFY-...` | ✅ Configured | `eonarch_prompt.txt` |
| DAARWIZZ | daarwizz | - | - | `daarwizz_prompt.txt` |
| Druid | druid | - | - | `druid_prompt.txt` |
| GreenFood | greenfood | - | - | `greenfood_prompt.txt` |
**Дата впровадження:** 2026-01-29
### Canonical Source
```
config/agent_registry.yml ←── ЄДИНЕ ДЖЕРЕЛО ІСТИНИ
│
│ python3 tools/agents generate
▼
┌────────────────────────────────────────────────────────┐
│ 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/` | Порти, сервіси, конфігурація |
| infrastructure_quick_ref.ipynb | `/github-projects/microdao-daarion/docs/` | Швидка довідка |
| NODA1-CURRENT-STATUS-2026-01-26.md | `/github-projects/microdao-daarion/` | Поточний статус NODA1 |
| NODA1-V2-DEPLOYMENT.md | `/github-projects/microdao-daarion/` | Детальний deployment report |
| **NODA1-AGENT-ARCHITECTURE.md** | `docs/` | **Повна схема підключення агентів** |
| **agent_registry.yml** | `config/` | **Canonical Source of Truth для агентів** |
| **README.md (config)** | `config/` | Як додавати нових агентів |
| 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, біотех, інновації
- Токен: `8436880945:AAEi-HS6GEctddoqBUd37MHfweZQP-OjRlo`
- Конфіг додано в `http_api.py` ✅
- Токен додано в `docker-compose.node1.yml` ✅
1. **Alateya** — R&D, біотех, інновації (з CrewAI командою "професорів")
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"** — потрібно перевірити мережу
2. **Alateya токен не був раніше доданий** — виправлено сьогодні
3. **Clan, Eonarch не були в production репо** — додано сьогодні
1. ~~**gateway → router: "All connection attempts failed"**~~ — ✅ Виправлено (router підключено до dagi-network)
2. ~~**Alateya токен не був раніше доданий**~~ — ✅ Виправлено
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