<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->

# API Reference — Measuring Training Effectiveness

## Agent Script

### Commands

| Command | Description |
|---|---|
| `node agent.js assess --level kirkpatrick-all --program annual-2026` | Run full Kirkpatrick assessment |
| `node agent.js correlate --training-data lms.csv --incident-data siem.csv` | Correlate training with incidents |
| `node agent.js roi --program-cost 150000 --incident-reduction 35` | Calculate training program ROI |
| `node agent.js benchmark --industry financial-services --year 2026` | Benchmark against industry standards |

### Examples

```bash
# Primary workflow
node agent.js assess --level kirkpatrick-all --program annual-2026

# Secondary analysis
node agent.js correlate --training-data lms.csv --incident-data siem.csv

# Generate deliverable
node agent.js roi --program-cost 150000 --incident-reduction 35

# Measure and report
node agent.js benchmark --industry financial-services --year 2026
```

## External Tools

| Tool | Command | Purpose |
|---|---|---|
| LMS API | `curl -X GET https://lms/api/v1/assessments` | Assessment data extraction |
| Python pandas | `python3 -c 'import pandas as pd'` | Data analysis and correlation |
| Jupyter | `jupyter notebook effectiveness-analysis.ipynb` | Interactive analysis |

## Kirkpatrick Four-Level Model

| Level | Measures | Methods |
|---|---|---|
| 1 - Reaction | Satisfaction, relevance | Post-training surveys |
| 2 - Learning | Knowledge gain | Pre/post assessments |
| 3 - Behavior | On-the-job application | Phishing sim results, observations |
| 4 - Results | Business impact | Incident reduction, cost avoidance |
