Files
APAW/agent-evolution/MILESTONE_ISSUES.md
¨NW¨ 15a7b4b7a4 feat: add Agent Evolution Dashboard
- Create agent-evolution/ directory with standalone dashboard
- Add interactive HTML dashboard with agent/model matrix
- Add heatmap view for agent-model compatibility scores
- Add recommendations tab with optimization suggestions
- Add Gitea integration preparation (history timeline)
- Add Docker configuration for deployment
- Add build scripts for standalone HTML generation
- Add sync scripts for agent data synchronization
- Add milestone and issues documentation
- Add skills and rules for evolution sync
- Update AGENTS.md with dashboard documentation
- Update package.json with evolution scripts

Features:
- 28 agents with model assignments and fit scores
- 8 models with benchmarks (SWE-bench, RULER, Terminal)
- 11 recommendations for model optimization
- History timeline with agent changes
- Interactive modal windows for model details
- Filter and search functionality
- Russian language interface
- Works offline (file://) with embedded data

Docker:
- Dockerfile for standalone deployment
- docker-compose.evolution.yml
- docker-run.sh/docker-run.bat scripts

NPM scripts:
- sync:evolution - sync and build dashboard
- evolution:open - open in browser
- evolution:dashboard - start dev server

Status: PAUSED - foundation complete, Gitea integration pending
2026-04-05 19:58:59 +01:00

183 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`