v0.2.0 — 2025-08-22 · Claude Hooks, Tool Runner, and Sessions
This release introduces provider-aware hooks, first-class tool execution, and session transcripts to make agents safer, more extensible, and easier to observe.
- HookManager (new): Run user-defined commands at key events (SessionStart, PreToolUse, PostToolUse, Stop), with safe glob matching and real execution timeouts by default.
- ToolRunner + File Tools: Wraps tool calls with pre/post hooks. Includes
Read
and Write
tools to interact with the workspace. - Session transcripts: Every run appends JSONL logs under
.verifier/sessions/
for auditing and debugging. - CLI UX:
verifier list
now shows agent id, name, and description. verifier hooks
summarizes configured hooks and guides setup when missing. - Docs: Added
docs/hooks.md
quick start with config and a sample hook script.
Feature intent
HookManager enables “policy at the edges”: teams can inject lightweight guardrails and context—without modifying agent code. Timeouts and safe matching prevent misconfigured hooks from hanging or overreaching. Together with ToolRunner and session logs, this lays the foundation for trustworthy, auditable automation.
Upgrade notes
- Default hook timeout is 10s. Increase per-hook via
timeout
in .verifier/config.yaml
. - For a quick start, create
.verifier/config.yaml
and run verifier hooks
— see docs/hooks.md
.