signal-bot/tool/trap_categories.json
Krzysztof kuhy Rudnicki 14d422295f feat: a word with two meanings gets the one made of steel
!pułapka (and !trap, !sidła, !wnyk, !potrzask, 26 spellings in all) posts a
photograph of the literal device -- a bear trap, a mousetrap, a snare, a fish
weir -- captioned with what Commons says it is.

The pool is 2218 Commons page ids, harvested by tool/gen_traps.py from a
curated seed list and committed. Page ids and not filenames on purpose: a
filename carries photographers' and sitters' names, and one of those
colliding with a label somebody mints from the chat would wedge
check_personal_data.py permanently, over data nobody can edit by hand.
_repo_vocabulary() subtracts aliases.json and nothing else, so it would not
have caught it. An integer cannot carry a name.

Nothing is cached. !papież caches because 267 portraits are a closed set a
group works through; a uniform draw from 2218 warms a cache essentially
never, so this fetches per call the way !kot and !pies do.

What the harvest measured, and now enforces:

- five plausible seed categories do not exist (Snares, Man traps, Hunting
  traps, Wasp traps, Animal trapping). A missing category is an empty answer,
  not an error, so verify_seeds() asks Commons before harvesting and fails
  loudly naming all of them.
- depth three from Category:Fish traps reaches Alfred Sisley's net paintings.
  Depth one, from seeds picked by hand.
- "<thing> in art" categories are paintings: Mousetraps in art put a Robert
  Campin altarpiece in the pool. Pruned by pattern, since Commons mints a new
  one whenever somebody needs it. Booby traps, the Wolfsangel, camera traps
  and animals dying in traps are pruned by name.
- Commons rate-limits hard, so a partial harvest must not be committed
  silently: 429 backs off, and a short pool refuses to write at all.

Descriptions are HTML and sometimes say nothing, so the tags come out, the
Fisheries records' trailing catalogue list is cut, a description naming only
the country falls back to the filename, and the file's own page is always
linked.

!łapka is not an alias: it resolves to !papa at distance two, which
test_nearest.py fails on, and rightly -- the suggestion would be a coin toss.

signal_bot/commons.py is the imageinfo query both Commons commands now share;
portraits.py keeps its behaviour and its tests unchanged.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01416TegJ3sa8xL5qGGgrygP
2026-08-31 18:01:27 +02:00

59 lines
2.9 KiB
JSON

{
"_comment": "Which Commons categories !pulapka draws from. Data, not source, for the reason aliases.json is: changing the policy should never mean touching Python. Every seed is checked against Commons before the harvest starts -- Snares, Man traps, Hunting traps, Wasp traps and Animal trapping all look like plausible names and none of them exists, so a typo would otherwise remove a whole subject in silence. by-function and by-animal are container categories whose immediate children hold the leg-hold, deadfall and per-species traps.",
"_excluded_comment": "Pruned as whole subtrees, never enqueued and never read. The command posts an attachment with no caption into a group chat, so this list is the only place the content of that attachment can be decided at all. Camera traps are photographs taken *by* a trap and drown the pool; booby traps reach wartime propaganda including a poster whose title carries a racial slur; the Wolfsangel is a heraldic charge that is also a neo-Nazi symbol; the mice categories are animals dying; the rest are geology, botany, paintings, architecture and bait rather than devices.",
"seeds": [
"Category:Traps",
"Category:Traps by function",
"Category:Traps by animal",
"Category:Mousetraps",
"Category:Rat traps",
"Category:Mole traps",
"Category:Bear traps",
"Category:Leghold traps",
"Category:Snare traps",
"Category:Cage traps",
"Category:Live capture traps",
"Category:Pitfall traps",
"Category:Trapping pits",
"Category:Deadfall traps",
"Category:Mantraps",
"Category:Fish traps",
"Category:Lobster traps",
"Category:Crab traps",
"Category:Eel traps",
"Category:Fyke nets",
"Category:Fly traps",
"Category:Flypaper",
"Category:Insect traps"
],
"excluded": [
"Category:Animals in traps",
"Category:Baits",
"Category:Booby traps",
"Category:Booby traps in the Vietnam War",
"Category:Camera traps",
"Category:Carnivorous plants with prey",
"Category:Fishing bait",
"Category:Fixed gillnets",
"Category:Glue traps",
"Category:Mammals in traps",
"Category:Mice in cage traps",
"Category:Mice in glue mousetraps",
"Category:Mice in spring-loaded bar traps",
"Category:Petroleum traps",
"Category:Rodent bait stations",
"Category:Tar baby",
"Category:Trapdoors",
"Category:Traps in art",
"Category:Traps in heraldry",
"Category:Traps of carnivorous plants",
"Category:Videos of mice in mousetraps",
"Category:Wolfsangel"
],
"prune_patterns": [
" in art",
" in heraldry"
],
"_prune_comment": "Any subcategory whose title contains one of these is pruned wholesale. Measured: Category:Mousetraps in art put a Robert Campin altarpiece panel and an 18th-century oil of a street vendor into the pool, and both arrive with no caption to explain why a painting is the answer to !pulapka. A pattern rather than a list because Commons mints a new '<thing> in art' category whenever somebody needs one."
}