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

# useCommitTask

> The master hook that executes the Triple-Write when the user commits.

# useCommitTask

The useCommitTask hook (hooks/useCommitTask.ts) is the master orchestrator that fires when the user presses "Commit" on the wizard hub. It is the largest hook in the application (\~450 lines).

***

## Execution Sequence

1. **Validate** the draft via validateTaskDraft()
2. **Acquire** the SyncLock mutex
3. **Execute** the Triple-Write Orchestrator:
   * Step 1: Convex mutation to create/update the task and generate instances
   * Step 2: Local SQLite write via insertTaskToLocalDb()
   * Step 3: Hardware alarm sync via scheduleNextAlarm()
4. **Handle** success or rollback failure
5. **Release** the SyncLock
6. **Navigate** back to the dashboard

***

## Penalty Photo Upload

If the penalty type is embarrassing\_photo, this hook handles the photo upload to Convex Storage before executing the Triple-Write. The upload generates a storage ID that is embedded in the penalty config.

***

## Error Handling

On failure, the Triple-Write Orchestrator automatically rolls back completed steps. If rollback itself fails, the rollbackFailed flag signals HydrationSync to perform a full reconciliation on the next cycle.