GeiserX/gramps-web-toolkit

gramps-web-toolkit is a set of command-line tools for running AI research agents against a family tree in Gramps Web without letting them write guesses into it. Each tool fixes a failure we hit while running about 30 research rounds over two trees of roughly 10,000 people each. The pipeline design and every trap it taught us sit next to the code.
The toolkit works for genealogy in any country. One module, spanish-poller, is Spain-only: it watches the Spanish Ministry of Justice sede and the DEHú notification inbox. In gwt-fetch, iiif works with any IIIF archive, while digibib, gazeta and geo cover Spanish sources and europeana searches every provider in any country (--provider Hispana narrows it to Spain).
## Features
gwt-apply: applies a JSON Lines change list to a tree, reads before every write, skips what is already there, and stays dry-run until you pass --apply
gwt-check: reads the whole tree after an apply and reports orphans, dangling links, broken birth and death pointers, likely duplicates, dates that contradict each other and what changed since the last copy, with a self-test that plants every error kind
gwt-import-excel: turns a research workbook into a gwt-apply change list for review
gwt-fetch: downloads archive images and text without a browser, with one manifest row per file: any IIIF archive, Europeana search, plus Spanish sources (DIGIBIB, the historical Gaceta de Madrid, CartoCiudad geocoding)
gwt-ledger: a shared "already searched" ledger, so parallel agents stop repeating each other's negative searches
gwt-queue: a durable "what to search next" queue that hands prioritized tasks to lanes, reopens the claims of dead lanes and backs off the tasks that keep failing
gwt-leads: reads a tree dump offline and lists the gaps (lines that stop, missing vitals, uncited facts), ranked with the root's direct ancestors first, as gwt-queue tasks
gwt-fscache: an on-disk HTTP cache for rate-limited genealogy APIs that never stores a block or an auth header
gwt-rank: orders record-search results by how well they fit a person in the tree, from the cached FamilySearch JSON or from page text, and never hides a row
gwt-mh: MyHeritage record search, record pages and originals through a signed-in browser
gwt-read: record search and records on FamilySearch and PARES, index search on Genae, and a name in the BOE and Gaceta de Madrid, slow and cached so the account is not suspended; and INSEE's French deaths files, read offline
gwt-gate: one request pace shared by every agent on a machine, which backs off on a block and lets priority lanes go first
gwt-rawstore: keeps source images in an S3-compatible bucket and only a small manifest in git
gwt-spanish-poller (Spain only): watches Spanish civil-registry requests and the DEHú inbox read-only, and flags cases that vanish
ocr-bench: scores OCR, HTR and LLM readings of the same pages on how many names they recover
gwt-report: names how two people are related (in English, Spanish and French) with their common ancestors and implex, and lists what is new in the tree since the family was last told, with links
gwt-geocode: puts coordinates on the places a tree's events use, in any country, as a change list for gwt-apply, so the Gramps Web map fills in