APAW/agent-evolution/MILESTONE_ISSUES.md

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:

"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)

Команды:

# 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