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

# API Reference — Security Culture Programs

## Agent Tools

| Tool | Description |
|---|---|
| Culture Assessor | `assess_culture(survey, behavior)` — Measure maturity |
| Campaign Planner | `plan_campaign(theme, weeks, channels)` — Schedule campaign |
| Champions Tracker | `track_champions(data)` — Monitor effectiveness |

## CLI Usage

```bash
# Assess culture
node agent.js culture --survey '{"awareness": 3.5}' --behavior '{"phishing": 4.0}'

# Plan campaign
node agent.js campaign --theme "Social Engineering" --weeks 4 --channels '["slack"]'

# Track champions
node agent.js champions --data '[{"name": "Alice", "active": true, "reports": 15}]'
```

## Output Format

All commands return JSON with the following structure:

```json
{
  "action": "<command_name>",
  "...": "command-specific fields"
}
```

## Error Handling

- Invalid input returns `{"error": "description"}` with non-zero exit code
- JSON parsing errors are caught and reported with context
- Missing required arguments trigger argparse help display
