> ## Documentation Index
> Fetch the complete documentation index at: https://committ.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Penalty Waivers Flow

> CAPTCHA, paragraph transcription, and waiver setup screens.

# Penalty Waivers Flow

The (penaltywaiver) route group configures the second-chance challenges that allow a user to cancel a pending penalty by completing redemption tasks.

***

## Waiver Types

| Type          | Challenge                                   | Difficulty                        |
| :------------ | :------------------------------------------ | :-------------------------------- |
| **CAPTCHA**   | Solve N CAPTCHA puzzles within the deadline | Configurable count and difficulty |
| **Paragraph** | Transcribe a given text passage accurately  | Length-based difficulty           |

***

## Configuration Screen

The setup.tsx screen allows the user to configure:

* **Waiver type** -- CAPTCHA or Paragraph
* **Count/Length** -- How many CAPTCHAs or how long the paragraph
* **Difficulty** -- Easy, Medium, Hard
* **Deadline** -- Minutes allowed to complete the challenge (default: 60 minutes)

***

## State Synchronization

Waiver configuration syncs to the draft store via useWaiverSync:

```typescript theme={null}
penalty_waiver: {
  type: "captcha",
  config: { count: 5, difficulty: "medium" },
  deadline_minutes: 60
}
```

***

## Waiver Lifecycle

When a commitment fails, the waiver challenge is offered. A durable Convex scheduled function (the penalty "bomb") is armed with the deadline. The only way to defuse it is by completing the challenge, which calls ctx.scheduler.cancel(penalty\_job\_id).