hiveguard challenge

The challenge command group is useful for testing challenge generation without a full client integration.

challenge generate

Generate a challenge and print it.

hiveguard challenge generate
hiveguard challenge generate image
hiveguard challenge generate text

Requires an API key (HIVEGUARD_API_KEY or config file).

Output:

{
  "challenge_id": "chal_abc123",
  "items": [
    {
      "id": "item_xyz",
      "data_ref": "https://cdn.example.com/img001.jpg",
      "modality": "image",
      "prompt": "Does this image contain a cat?"
    }
  ],
  "expires_at": "2024-01-01T12:05:00Z"
}

If the challenge pool is empty, the server returns 204 (Tier-4 fail-open) and the CLI prints:

No challenge available — challenge pool is empty.
Upload ground-truth items to enable challenges: hiveguard items upload FILE

Modality filter

Pass a modality to request a specific type of challenge:

hiveguard challenge generate image
hiveguard challenge generate text
hiveguard challenge generate audio

If no items of that modality exist in the pool, the server returns the next available modality or 204.