# Agent Evolution Dashboard - Milestone & Issues

## Milestone: Agent Evolution Dashboard

**Title:** Agent Evolution Dashboard
**Description:** Интерактивная панель для отслеживания эволюции агентной системы APAW с интеграцией Gitea
**Due Date:** 2026-04-19 (2 недели)
**State:** Open

---

## Issues

### Issue 1: Рефакторинг из архива в root-директорию

**Title:** Рефакторинг: перенести agent model research из archive в agent-evolution
**Labels:** `refactor`, `high-priority`
**Milestone:** Agent Evolution Dashboard

**Описание:**
Файл `archive/apaw_agent_model_research_v3.html` содержит ценную информацию о моделях и рекомендациях. Необходимо:

1. ✅ Создать директорию `agent-evolution/` в корне проекта
2. ✅ Создать `agent-evolution/index.standalone.html` с интегрированными данными
3. ✅ Создать `agent-evolution/data/agent-versions.json` с актуальными данными
4. ✅ Создать `agent-evolution/scripts/build-standalone.cjs` для генерации
5. 🔄 Удалить `archive/apaw_agent_model_research_v3.html` после переноса данных

**Критерии приёмки:**
- [ ] Все данные из архива интегрированы
- [ ] Дашборд работает автономно (file://)
- [ ] Данные актуальны на момент коммита

---

### Issue 2: Интеграция с Gitea для истории изменений

**Title:** Интеграция Agent Evolution с Gitea API
**Labels:** `enhancement`, `integration`, `high-priority`
**Milestone:** Agent Evolution Dashboard

**Описание:**
Требуется интегрировать дашборд с Gitea для:

1. Получения истории изменений моделей из issue comments
2. Парсинга комментариев агентов (формат `## ✅ agent-name completed`)
3. Извлечения метрик производительности (Score, Duration, Files)
4. Отображения реальной истории в дашборде

**Требования:**
- API endpoint `/api/evolution/history` для получения истории
- Webhook для автоматического обновления при новых комментариях
- Кэширование данных локально
- Fallback на локальные данные при недоступности Gitea

**Критерии приёмки:**
- [ ] История загружается из Gitea при наличии API
- [ ] Fallback на локальные данные
- [ ] Webhook обрабатывает `issue_comment` события
- [ ] Данные обновляются в реальном времени

---

### Issue 3: Синхронизация с capability-index.yaml и kilo.jsonc

**Title:** Автоматическая синхронизация эволюции агентов
**Labels:** `automation`, `sync`, `medium-priority`
**Milestone:** Agent Evolution Dashboard

**Описание:**
Создать автоматическую синхронизацию данных эволюции из:

1. `.kilo/agents/*.md` - frontmatter с моделями
2. `.kilo/capability-index.yaml` - capabilities и routing
3. `.kilo/kilo.jsonc` - model assignments
4. Git history - история изменений
5. Gitea issue comments - performance metrics

**Скрипты:**
- `agent-evolution/scripts/sync-agent-history.ts` - основная синхронизация
- `agent-evolution/scripts/build-standalone.cjs` - генерация HTML

**NPM Scripts:**
```json
"sync:evolution": "bun run agent-evolution/scripts/sync-agent-history.ts && node agent-evolution/scripts/build-standalone.cjs",
"evolution:dashboard": "bunx serve agent-evolution -l 3001",
"evolution:open": "start agent-evolution/index.standalone.html"
```

**Критерии приёмки:**
- [ ] Синхронизация работает корректно
- [ ] HTML генерируется автоматически
- [ ] Данные консистентны

---

### Issue 4: Документация и README

**Title:** Документация Agent Evolution Dashboard
**Labels:** `documentation`, `low-priority`
**Milestone:** Agent Evolution Dashboard

**Описание:**
Создать полную документацию:

1. ✅ `agent-evolution/README.md` - основная документация
2. 🔄 `docs/agent-evolution.md` - техническая документация
3. 🔄 Инструкция по запуску в `AGENTS.md`
4. ✅ Schema: `agent-evolution/data/agent-versions.schema.json`
5. ✅ Skills: `.kilo/skills/evolution-sync/SKILL.md`
6. ✅ Rules: `.kilo/rules/evolutionary-sync.md`

**Критерии приёмки:**
- [ ] README покрывает все сценарии использования
- [ ] Техническая документация описывает API
- [ ] Есть примеры кода

---

### Issue 5: Docker контейнер для дашборда

**Title:** Docker-изация Agent Evolution Dashboard
**Labels:** `docker`, `deployment`, `low-priority`
**Milestone:** Agent Evolution Dashboard

**Описание:**
Упаковать дашборд в Docker для простого деплоя:

**Файлы:**
- ✅ `agent-evolution/Dockerfile`
- ✅ `docker-compose.evolution.yml`
- ✅ `agent-evolution/docker-run.sh` (Linux/macOS)
- ✅ `agent-evolution/docker-run.bat` (Windows)

**Команды:**
```bash
# Linux/macOS
bash agent-evolution/docker-run.sh restart

# Windows
agent-evolution\docker-run.bat restart

# Docker Compose
docker-compose -f docker-compose.evolution.yml up -d
```

**Критерии приёмки:**
- [ ] Docker образ собирается
- [ ] Контейнер запускается на порту 3001
- [ ] Данные монтируются корректно

---

## Статус напраления

**Текущий статус:** `PAUSED` - приостановлено до следующего спринта

**Причина паузы:**
Базовая инфраструктура создана:
- ✅ Структура директорий `agent-evolution/`
- ✅ Данные интегрированы в HTML
- ✅ Скрипты синхронизации созданы
- ✅ Docker контейнер настроен
- ✅ Документация написана

**Что осталось:**
- 🔄 Issue #2: Интеграция с Gitea API (требует backend)
- 🔄 Issue #3: Полная синхронизация (требует тестирования)
- 🔄 Issue #4: Расширенная документация

**Резюме работы:**
Создана полноценная инфраструктура для отслеживания эволюции агентной системы. Дашборд работает автономно без сервера, включает данные о 28 агентах, 8 моделях, рекомендациях по оптимизации. Подготовлен foundation для будущей интеграции с Gitea.

---

## Quick Links

- Dashboard: `agent-evolution/index.standalone.html`
- Data: `agent-evolution/data/agent-versions.json`
- Build Script: `agent-evolution/scripts/build-standalone.cjs`
- Docker: `docker-compose -f docker-compose.evolution.yml up -d`
- NPM: `bun run sync:evolution`