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

# API Reference — Security Innovation Labs

## Agent Tools

| Tool | Description |
|---|---|
| Tech Evaluator | `evaluate_technology(name, scores, weights)` — Weighted assessment |
| POC Planner | `plan_poc(tech, weeks, criteria)` — Structure evaluation |
| Pipeline Tracker | `track_pipeline(projects)` — Monitor project status |

## CLI Usage

```bash
# Evaluate tech
node agent.js evaluate --name "AI-SIEM" --scores '{"value": 8}' --weights '{"value": 0.3}'

# Plan POC
node agent.js poc --tech "XDR" --weeks 4 --criteria '["detection > 90%"]'

# Track pipeline
node agent.js pipeline --projects '[{"name": "AI-SIEM", "stage": "evaluate"}]'
```

## 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
