Technical reference. Written for analysts and AI agents and kept in sync with the repository, so it uses internal terms. Raw Markdown: /pages/review-queue.md.
Exception review queue — Ho Hum (read-only view)
Human-in-the-loop desk for Better World. Agents draft; Ho Hum decides.
This page is a read-only snapshot of open items. Live data: data/review/queue.json · API: GET /v1/review/queue (default ?status=open; use ?status=all for history).
| Field | Value |
|---|---|
| Generated | 2026-10-01 |
| Open | 2 |
| Approved (history) | 3 |
| Schema | schema/exception_review.schema.json |
| Ops | docs/exception-review-ops.md |
| Red lines | docs/red-lines-and-exceptions.md |
How Ho Hum resolves (offline — no write API)
- List open items:
python3 scripts/list_review_queue.pyorcurl -s 'http://127.0.0.1:8787/v1/review/queue'. - Open the cited
source(org JSON, claims index, trust flags). - Decide approved or rejected.
- Edit
data/review/queue.jsonby hand — setstatus, fillreviewer_notes. - If data must change, edit the cited
data/orgs/*.jsonwith citations only, then runpython3 scripts/lint_data.pyandpython3 scripts/lint_honesty.py.
There is no POST /v1/review/... approve endpoint and must not be one without auth. Agents must never auto-clear trust flags to close a ticket.
Open items
1. exc_20261001_actra_donate — high / open
| org_id | org_actra |
| claim_id | — |
| requested_by | lint |
| created_at | 2026-10-01 |
| source | data/orgs/org_actra.json#trust |
Reason
org_actra now has website + donate_url on file, but trust.website_reachable=unchecked, donate_url_status=none, http_checks=[], and flags still include WEBSITE_NOT_ON_FILE / HTTP_CHECK_PENDING / WEBSITE_UNVERIFIED. Human HTTP verification (or intentional mark) still needed before recommending a giving path. Do not invent CE.
Recommended human action
HTTP-verify (or intentionally mark) org_actra website + donate_url; update trust.website_reachable, donate_url_status, http_checks[]; clear WEBSITE_NOT_ON_FILE / HTTP_CHECK_PENDING / WEBSITE_UNVERIFIED only with evidence. Then set this queue item status=approved|rejected with reviewer_notes. Do not invent CE or URLs. Offline edit: data/orgs/org_actra.json + data/review/queue.json.
2. exc_20261001_actra_claim_shallow — medium / open
| org_id | org_actra |
| claim_id | eval_org_actra__0 |
| requested_by | agent |
| created_at | 2026-10-01 |
| source | data/claims_index.json#eval_org_actra__0 |
Reason
Contested presentation risk: claim eval_org_actra__0 (WELLBYs per $1,000 = 37, unit WELLBY_per_1000_USD, period HLI honourable) is verified=true from HLI's honourable-mention list but confidence=low and org summary calls it a shallow prediction. Human should confirm UI/API never presents this as HLI Top Charity CE, and that honourable_mention tier stays visible.
Recommended human action
Confirm recommend/compare and org pages never present claim eval_org_actra__0 (HLI honourable / low-confidence WELLBY) as Top Charity CE; keep honourable_mention / shallow labeling visible. If presentation is already honest, approve with notes; else reject any elevation and fix copy. Do not invent CE. Offline edit: data/review/queue.json (+ org/claim docs if needed).
Recently approved (context)
Not actionable — listed so agents do not re-open without new evidence.
exc_20261001_path_ein(org_path) — Resolved by enrichment_pass 2026-10-01: PATH EIN 91-1157127 from official finances page; matched EO BMF → irs_status=exempt_501c3_eo_bmf. See data/qa/enrichment…exc_20261001_living_goods_ein(org_living_goods) — Resolved by enrichment_pass 2026-10-01: Living Goods EIN 20-5010527 from official donate page; matched EO BMF → irs_status=exempt_501c3_eo_bmf. See data/qa/enri…exc_20261001_gw_tcf_irs_claimed(org_givewell_top_charities_fund) — Resolved by enrichment_pass 2026-10-01: GiveWell funds (Top Charities / All Grants / Unrestricted) use Clear Fund EIN 20-8625442; matched EO BMF → irs_status=ex…
Agent rules
- Never auto-clear trust flags (
WEBSITE_*,HTTP_CHECK_PENDING,EIN_UNKNOWN,IRS_TEOS_LOOKUP_PENDING, etc.) to make a recommendation look clean. - Never invent CE, EINs, donate URLs, or IRS statuses while “helping” clear the queue.
- Leave status
openuntil Ho Hum edits the JSON. - Surface open exceptions when recommending the same
org_id.
CLI: python3 scripts/list_review_queue.py · Demo panel: /demo/ section “Exception review”.