codex-stop-truth-gate

hook Stop codex mode: enforce

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

Registry Entry

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

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

Full hook config + command reference

config/hook-registry.json (entry)

{
  "id": "codex-stop-truth-gate",
  "description": "Ask Codex 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 codex-stop-truth-gate --harness {harness}",
  "timeout": 5,
  "harnesses": [
    "codex"
  ]
}

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 codex-stop-truth-gate --harness codex

Resources

Hooks Hub All repo-managed lifecycle hooks.

wagents hooks Inspect and validate hooks via CLI.

---

View source on GitHub