## Setup

### Prerequisites

1. A HashBox iOS app account
2. A valid `HB-` prefixed API token from your HashBox dashboard

### Configuration

Before using the plugin, configure it with your HashBox API token using the `configure_hashbox` tool:

This stores your configuration locally in `hashbox_config.json`.

## Usage

### configure_hashbox

Sets up the HashBox connection by saving your API token.

**Parameters:**

| Parameter | Type | Required | Description |
|---|---|---|---|
| `token` | string | Yes | Your HashBox API token (must start with `HB-`) |

**Example:**

### send_hashbox_notification

Sends a push notification to the HashBox iOS app through the configured Firebase webhook.

**Parameters:**

| Parameter | Type | Required | Description |
|---|---|---|---|
| `payloadType` | `"article"` \| `"metric"` \| `"audit"` | Yes | Type of notification payload |
| `channelName` | string | Yes | Name of the notification channel |
| `channelIcon` | string | Yes | Icon/emoji for the channel |
| `title` | string | Yes | Notification title |
| `contentOrData` | string \| MetricItem[] \| AuditFinding[] | Yes | Content body (string for article) or structured data (array for metric/audit) |

**Example (article):**

configure_hashbox({
  "token": "HB-your-token-here"
})

configure_hashbox({
  "token": "HB-abc123"
})

send_hashbox_notification({
  "payloadType": "article",
  "channelName": "Builds",
  "channelIcon": "🔨",
  "title": "Build Complete",
  "contentOrData": "Your project compiled successfully with 0 errors."
})

send_hashbox_notification({
  "payloadType": "metric",
  "channelName": "Performance",
  "channelIcon": "📊",
  "title": "Daily Metrics",
  "contentOrData": [
    { "label": "CPU Usage", "value": 42, "unit": "%" },
    { "label": "Memory", "value": 8.2, "unit": "GB" }
  ]
})

send_hashbox_notification({
  "payloadType": "audit",
  "channelName": "Security",
  "channelIcon": "🔒",
  "title": "Audit Log",
  "contentOrData": [
    { "severity": "info", "message": "User logged in from new device" }
  ]
})