APAW/agent-evolution

APAW Agent Evolution Dashboard

Overview

This is a standalone HTML dashboard that visualizes agent model assignments, performance scores, and recommendations for the APAW codebase.

Features

• Real-time agent model & performance tracking
• Agent × Model compatibility heatmap
• Performance impact analysis with Chart.js visualizations
• Model recommendation engine with priority scoring
• Evolution timeline and history tracking

Data Sources

The dashboard pulls data from three primary sources:

1. .kilo/agents/*.md - Agent definitions with model assignments, modes, colors, and descriptions
2. kilo-meta.json - Central registry of agent metadata, categories, and capabilities
3. model-benchmarks-verified.json - IF scores and context window data for all supported models

Build Process

The build-standalone-fixed.cjs script:

1. Parses all agent YAML frontmatter
2. Computes composite performance scores using IF scores and context windows
3. Generates model recommendations based on score improvements
4. Embeds unified JSON data directly into the HTML file
5. Updates JavaScript functions to use embedded data

Incremental DB Sync

The watch-db.cjs script provides incremental database synchronization:

1. Watches for changes in .kilo/agents/*.md and kilo-meta.json
2. Only processes changed files (incremental update)
3. Determines change type (model_change vs prompt_change)
4. Updates database with new versions and metadata
5. Exports updated data to JSON
6. Clean shutdown on SIGINT/SIGTERM
7. Configurable polling interval via WATCH_INTERVAL_MS env var
8. Logging to .kilo/logs/watch-db.log

Validation

The build process ensures:

• ✅ No unicode escape sequences (no \u003c or \u003e characters)
• ✅ Valid embedded JSON structure
• ✅ Clean standalone HTML file with no external dependencies
• ✅ Proper function updates (init, renderHeatmap, renderRecommendations)

Output Files

• index.standalone.html - Self-contained dashboard with embedded data
• data/index.html - Copy of standalone dashboard for web serving

Usage

Simply open index.standalone.html in any modern browser. No server or external dependencies required.

To run the incremental DB watcher:

# Run with default 60 second interval
node agent-evolution/scripts/watch-db.cjs

# Run with custom interval (10 seconds)
WATCH_INTERVAL_MS=10000 node agent-evolution/scripts/watch-db.cjs

# Run in background
nohup node agent-evolution/scripts/watch-db.cjs > watch-db.log 2>&1 &

Agent Count

The dashboard currently tracks 34 agents across multiple categories:

• Core Development
• Quality Assurance
• Security
• Analysis
• Process Management
• Cognitive Enhancement
• Testing

Model Support

Supports 15 verified models with IF scores from artificialanalysis.ai:

• DeepSeek V4-Pro Max (IF: 89)
• DeepSeek V4-Flash (IF: 86)
• Kimi K2.6 (IF: 91)
• Qwen3-Coder 480B (IF: 88)
• GLM-5.1 (IF: 90)
• And 10 more models