- 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
183 lines
7.6 KiB
Markdown
183 lines
7.6 KiB
Markdown
# 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`
|