cursor-stop-truth-gate

hook Stop cursor mode: enforce

Ask Cursor for one more pass when final code-change claims omit validation evidence.

Registry Entry

Field	Value
id	cursor-stop-truth-gate
status_message	Checking final-answer evidence
mode	enforce
logical_event	Stop
command	python3 {repo_root}/hooks/wagents-hook.py cursor-stop-truth-gate --harness {harness}
timeout	5
harnesses	["cursor"]

Note

Stop hook policy _policy_codex_stop_truth_gate. Uses regexes for change claims vs. validation evidence; respects stop_hook_active guard. Emits block+reason for Cursor.

Full hook config + command reference

config/hook-registry.json (entry)

{
  "id": "cursor-stop-truth-gate",
  "description": "Ask Cursor for one more pass when final code-change claims omit validation evidence.",
  "status_message": "Checking final-answer evidence",
  "mode": "enforce",
  "logical_event": "Stop",
  "command": "python3 {repo_root}/hooks/wagents-hook.py cursor-stop-truth-gate --harness {harness}",
  "timeout": 5,
  "harnesses": [
    "cursor"
  ]
}

hooks/wagents-hook.py (policy + guard)

def _policy_codex_stop_truth_gate(payload: NormalizedPayload) -> int:
    if payload.stop_hook_active:
        return 0
    ...
    # checks last assistant message for claims without evidence
    if has_claim and not has_evidence:
        return _stop_retry(payload, "Add explicit validation evidence (tests, commands, diffs) before stopping.")
    return 0

Command: python3 .../wagents-hook.py cursor-stop-truth-gate --harness cursor

Resources

Hooks HubAll repo-managed lifecycle hooks.

wagents hooksInspect and validate hooks via CLI.

---

View source on GitHub