Update utils documentation

**Problem**
When working with hooks, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

No file, test, or entry point is named, so first locate the hook utilities and their current error paths in the repository. Confirm the expected descriptive messages with a maintainer, then add coverage for the agreed cases; done means hook failures provide the requested debugging context.

Written by the indexing model from the issue text.