# 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:
```bash
# 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