research-evidence-ledger

hook PostToolUse multi-harness mode: audit

Append lightweight provenance metadata for research retrieval tools.

Registry Entry

Field	Value
id	research-evidence-ledger
mode	audit
logical_event	PostToolUse
matcher	WebSearch|web_search|fetch|fetcher|trafilatura|docling|mcp__.*|mcp_.*
command	python3 {repo_root}/hooks/wagents-hook.py research-evidence-ledger --harness {harness}
timeout	5
harnesses	["codex", "claude-code", "github-copilot", "gemini-cli"]

Note

Mode=audit (non-blocking). _policy_evidence_ledger extracts URLs + tool context and appends to per-session ledger under ~/.codex/hook-ledger (or equiv for harness). Supports later verification in stop-verifier.

Full hook config + command reference

config/hook-registry.json (entry)

{
  "id": "research-evidence-ledger",
  "description": "Append lightweight provenance metadata for research retrieval tools.",
  "mode": "audit",
  "logical_event": "PostToolUse",
  "matcher": "WebSearch|web_search|fetch|fetcher|trafilatura|docling|mcp__.*|mcp_.*",
  "command": "python3 {repo_root}/hooks/wagents-hook.py research-evidence-ledger --harness {harness}",
  "timeout": 5,
  "harnesses": [
    "codex",
    "claude-code",
    "github-copilot",
    "gemini-cli"
  ]
}

hooks/wagents-hook.py (policy)

def _policy_evidence_ledger(payload: NormalizedPayload) -> int:
    if not _state_active(payload):
        return 0
    # extracts URLs from payload, writes JSONL provenance to audit ledger
    ...

Full URL extraction + ledger append in wagents-hook.py (and mirrored in research_hook.py).

Resources

Hooks Hub All repo-managed lifecycle hooks.

wagents hooks Inspect and validate hooks via CLI.

research skill Evidence ledger supports the research workflow.

---

View source on GitHub