research-stop-verifier

hook Stop codex,claude-code,gemini-cli mode: enforce

Verify research skill invariants before an active research session completes.

Registry Entry

Field	Value
id	research-stop-verifier
mode	enforce
logical_event	Stop
command	python3 {repo_root}/hooks/wagents-hook.py research-stop-verifier --harness {harness}
timeout	30
harnesses	["codex", "claude-code", "gemini-cli"]

Note

Longer timeout (30s). Policy _policy_stop_verifier loads research_hook and runs final invariant checks (ledger coverage, no unverified claims, state cleanup). Blocks stop on failure.

Full hook config + command reference

config/hook-registry.json (entry)

{
  "id": "research-stop-verifier",
  "description": "Verify research skill invariants before an active research session completes.",
  "mode": "enforce",
  "logical_event": "Stop",
  "command": "python3 {repo_root}/hooks/wagents-hook.py research-stop-verifier --harness {harness}",
  "timeout": 30,
  "harnesses": [
    "codex",
    "claude-code",
    "gemini-cli"
  ]
}

hooks/wagents-hook.py (policy)

def _policy_stop_verifier(payload: NormalizedPayload) -> int:
    research_hook = _load_research_hook_module()
    research_payload = _research_payload(payload, research_hook)
    return research_hook._policy_stop_verifier(research_payload)

Heavy verification implemented in skills/research/scripts/research_hook.py.

Resources

Hooks Hub All repo-managed lifecycle hooks.

wagents hooks Inspect and validate hooks via CLI.

research skill Stop verifier closes the research contract.

---

View source on GitHub