mirror of https://github.com/kuhyx/signal-bot.git synced 2026-11-10 19:27:20 +01:00

Krzysztof kuhy Rudnicki 08599e6056 feat: two commands that answer with somebody else's work

!sztuka posts a work of art, skewed 60% Polish; !wiersz posts one short
public-domain Polish poem, whole. Both follow the rule the rest of the bot
already keeps: the repository commits identifiers, and the words arrive over
the wire when somebody asks.

!wiersz was written the other way first, and the gate caught it. A pack of
short public-domain poems was harvested, name-filtered and committed, and
check_personal_data.sh refused it: three lines carried a real group member's
given name, and two still did after a filter that had discarded 31% of the
corpus. That is structural, not a tuning problem -- Polish verse capitalises
every line, so a line-initial capital carries no signal, and that is exactly
where a name sits. The pack now holds Wolne Lektury slugs; the poem, its
title and its author are fetched at post time and appear nowhere in git.
It is also the better version: with no name filter there are no false
positives, so the pool is larger and the attribution is a full name again.

The gate then refused the art category list too, over a painter whose given
name is somebody's. That is the popes.json case exactly, so it takes the
same answer: a file-scoped allowlist entry, still refused everywhere else.

The Commons harvest is now three modules by what they are, not by where the
line count fell: commons_api is the conversation with Commons, commons_harvest
turns categories into a pool of licensed page ids, commons_cache makes an
interrupted run resumable. Along the way it gained licences in the same
request that lists a category (the second pass was 1,500 requests at 2.3s
each), maxlag instead of a guessed sleep, 5xx retries because one 504 used to
destroy a whole run, and Wikidata for works by creators of Polish
citizenship: the Polish pool grew 15,221 -> 20,092.

Batching categories through CirrusSearch looked like a further 6x and was
measured out again: 2,404 files where the authoritative enumeration returns
2,429, a different ~1% missing on every run.

The offline run is 19s where it was four minutes, almost all of it the
deafness gate waiting out three thirty-second liveness probes to prove
something provable in three; the tick is configuration now, and e2e enforces
a 40s budget on itself so that never silently comes back.

2026-08-31 21:32:07 +02:00

11 KiB

Raw Blame History

Changelog

Releases are named after the popes, in order: release n is pope n. The version number is a pure function of that ordinal — see signal_bot/versioning.py for the two constants and why they are what they are. The short version is that Jan Paweł II has to land on 2.13.7, and everything else follows.

The name is Latin, and it is derived, not typed. latin_name() in signal_bot/versioning.py builds it from popes.json: the Latin stem plus the Roman numeral off the Polish name. So 0.0.3 is «Clemens I», not «Klemens I» and not the raw latin field's «Clemens Romanus»; 3.0.4 will be «Leo XIV», not «Leo Decimus Quartus». Ask the code rather than guessing:

python -c 'from signal_bot.versioning import *; print(latin_name(pope_for(14)))'

The same string goes in the release commit subject, in /healthz, and in the heading below.

The bot reads this file. The heading format is load-bearing:

## <version> — <pope name>
- <one change, in Polish, as the group will read it>

Add the new section at the top when you bump RELEASE_ORDINAL. Anything that is not a ## heading or a - bullet under one is ignored, so prose between releases is free. The heading name is checked rather than trusted — tests/test_changelog.py asserts it equals latin_name() for that version — and the announcement reads popes.json regardless, so a typo here fails the suite instead of reaching a group.

Preview the announcement before you bump. Because a bump is a publish, the announcement was the one feature that could never be exercised first. tool/preview_release.py testbot posts exactly what the next release would say, into one test group, touching neither RELEASE_ORDINAL nor any announced_version row; --print-only renders it without sending. It is fail-closed on SELFTEST_GROUPS, so it cannot post a release that does not exist into the group that would believe it. Write the ## section below first -- the preview reads it, so what you see is what ships.

A release announcement is a photo now. It carries the pope's portrait, his Latin name and his pl.wikipedia article, the same three things !papież posts. Only for the pope in the header: a backlog announcement lists up to ten releases, and ten attachments is the wall the cap exists to avoid. If Commons will not serve the portrait the announcement still goes out, as text — the announced_version marker is written before the send, so a failure there would otherwise cost that group its release notes permanently.

Every release takes the next pope, however small. A one-line fix consumes an ordinal exactly like a feature does; the ladder tracks releases, not importance. 0.0.4 and 0.0.5 were both bug fixes. Do not try to squeeze a fix out at the current version to "save" a pope -- there are 267 of them.

A version bump is a publish, not a checkpoint. Restarting the service after one posts these bullets into every watched group, including the real one. So exercise the feature in a test group — testbot, catbot, finaltestbot, each just you and the bot — before bumping RELEASE_ORDINAL, tagging or restarting. To try something at the current version without announcing, leave RELEASE_ORDINAL alone and restart. Green unit tests and a green scripts/e2e.sh are not sufficient evidence: e2e.sh runs against the local fake, so it proves the wiring and nothing about how Signal renders the result or how the real upstream API behaves. 0.0.3 shipped a !gekon that passed every gate and posted the same photo every time, because the one thing nobody had done was call the real endpoint twice.

Write bullets the group can notice. The audience is people in a chat, not this repo: describe what changes for them. 0.0.1 shipped a bullet about /healthz, an endpoint bound to 127.0.0.1 that nobody in a Signal group can reach, and it was rightly called out.

0.2.5 — Lucius I

papież nr 22 z 267, pontyfikat 253-254

dodano !sztuka — losowe dzieło sztuki, częściej polskie niż nie
dodano !wiersz — losowy krótki wiersz, w całości, z domeny publicznej

0.2.4 — Cornelius

papież nr 21 z 267, pontyfikat 251-253

dodano !traps

0.2.3 — Fabianus

papież nr 20 z 267, pontyfikat 236-250

jak wpiszecie komendę z literówką, bot podpowie tę właściwą: !cta dostaje odpowiedź „chodziło o !kot?”. Wcześniej milczał, więc pomyłka wyglądała dokładnie tak samo jak bot, który nie działa
komenda, której bot nie zna i do której nic nie pasuje, dostaje odpowiedź z podpowiedzią, co z tym zrobić
nowa komenda !zaproponuj — zapisuje pomysł na komendę, której jeszcze nie ma, np. !zaproponuj !pogoda pokaż pogodę na jutro. Pomysły trafiają na listę, którą czytam
każde !słowo, którego bot nie zna, jest zapisywane. To jest lista komend, które warto dopisać — więc wpisywanie ich ma sens nawet wtedy, kiedy jeszcze nie działają
bez zmian: zwykłe pisanie, samo !! i !kot z dopiskiem dalej nie wywołują żadnej odpowiedzi

0.2.2 — Anterus

papież nr 19 z 267, pontyfikat 235-236

album urósł do 180 zdjęć — każda komenda ma ich teraz więcej, a jedna zaczęła w ogóle działać: nie miała dotąd ani jednego zdjęcia, więc nie odpowiadała nikomu, kto ją wpisał
!dodaj przyjmuje wreszcie filmy. Do tej pory odrzucał każdy film: bot sprawdzał, czy z pliku zniknęły daty, a narzędzie, którym je usuwał, wcale ich nie usuwało — więc film nigdy nie przechodził tej kontroli
z filmów wycinana jest teraz też ścieżka, którą iPhone dopisuje obok obrazu: ramka po ramce, gdzie na nagraniu są twarze i który to numer twarzy. Nie da się jej usunąć jak zwykłych metadanych, bo to nie jest opis pliku tylko osobny strumień — więc film jest przepakowywany i zostaje w nim wyłącznie obraz i dźwięk
zdjęcia wrzucane hurtem z folderu przechodzą teraz dokładnie tę samą kontrolę metadanych co te z czatu — wcześniej były wgrywane jak leci
to samo zdjęcie wysłane dwa razy, pod dwiema nazwami albo raz z czatu i raz z folderu, trafia do albumu jeden raz
to samo co wcześniej: te komendy istnieją tylko w tej grupie

0.2.1 — Pontianus

papież nr 18 z 267, pontyfikat 230-235

zdjęcia można teraz dorzucać z czatu: podpisz wysyłane zdjęcie !dodaj <imię> i od razu wychodzi na !<imię>, bez restartu bota
można podać kilka etykiet naraz (!dodaj ktos ktos2) — zdjęcie dostaje wszystkie; można też wysłać kilka zdjęć w jednej wiadomości
etykieta, która nie pasuje do nikogo, zakłada nową — bot mówi wtedy, że powstała, i sięga się po nią przez !losowe <etykieta>
!losowe bez niczego to losowe zdjęcie z całego albumu
z każdego dodanego zdjęcia bot wycina metadane — w tym miejsce, w którym zostało zrobione, i model telefonu — po czym sprawdza, czy naprawdę zniknęły; jak nie potrafi tego zrobić, nie zapisuje zdjęcia w ogóle
kasuje też swoją kopię odebranego załącznika, żeby nie została poza albumem
w odpowiedzi są tylko liczby i skróty (dodano · p1: 4) — to, co wpisaliście, nie trafia ani do odpowiedzi, ani do logów
to samo co wcześniej: te komendy istnieją tylko w tej grupie

0.2.0 — Urbanus I

papież nr 17 z 267, pontyfikat 222-230

nowe komendy ze zdjęciami: każda osoba ma swoją, a kilka naraz (!ktos !ktos2) daje zdjęcie, na którym są wszyscy naraz
jak takiego zdjęcia nie ma, bot mówi to jednym zdaniem zamiast milczeć
filmiki też działają — lecą jako filmiki, a nie jako plik, którego nie da się odtworzyć
te komendy istnieją tylko w tej jednej grupie: w każdej innej nie ma ich wcale, !pomoc ich tam nie pokazuje i bot na nie nie odpowiada
zdjęcia i imiona nie są w kodzie bota ani nigdzie w internecie — leżą w jednym katalogu na komputerze i nigdy go nie opuszczają

0.1.7 — Callistus I

papież nr 16 z 267, pontyfikat 217-222

każda wersja mówi teraz, którym z kolei papieżem jest jej patron i w jakich latach panował — w ogłoszeniu nowej wersji, w changelogu i przy !papież
!papież pisze to samo zdaniem, którym opisuje każdego innego papieża, więc nie trzeba już zgadywać, czy «Callistus I» to ten piętnasty, czy szesnasty

0.1.6 — Zephyrinus

papież nr 15 z 267, pontyfikat 199-217

statystyki o 21:37 są od teraz o dzisiejszym dniu, a nie o wczorajszym — wieczorny post pokazuje wreszcie ten dzień, który właśnie mijał
licznik zamyka się o 21:37, więc to, co napiszecie później, wpada do jutra; post sam to mówi, żeby liczba nie udawała całej doby
jedna wiadomość, nie kilka: dzień, tydzień, miesiąc i to, co bot przegapił, są blokami w jednym poście, a nie osobnymi powiadomieniami
dzień, którego bot przegapił (bo go nie było o 21:37), nadal zostanie wysłany później — nic nie ginie

0.1.5 — Victor I

papież nr 14 z 267, pontyfikat 189-199

ogłoszenie nowej wersji przychodzi teraz ze zdjęciem papieża, po którym ta wersja się nazywa, i z linkiem do jego strony na polskiej Wikipedii — dokładnie tak, jak robi to !papież
wersje nazywają się od teraz po łacinie: ta jest «Victor I», a nie «Wiktor I», a poprzednia była «Eleutherius», nie «Eleuteriusz»

0.1.4 — Eleutherius

papież nr 13 z 267, pontyfikat 175-189

!pomoc (albo !help) wypisuje wszystkie komendy i mówi jednym zdaniem, co każda robi — do tej pory nigdzie na czacie nie było ich listy

0.1.3 — Soterius

papież nr 12 z 267, pontyfikat 166-175

"POCZEKAJ 1 SEKUND" odmienia się wreszcie po polsku — teraz jest 1 SEKUNDĘ, 2 SEKUNDY, 5 SEKUND
odczekanie tego, co bot każe, wreszcie działa: dotąd każda nieudana próba po cichu przedłużała blokadę, więc kto grzecznie czekał, ten dostawał odmowę w kółko

0.1.2 — Anicetus

papież nr 11 z 267, pontyfikat 155-166

!ja pokazywał wszystkim tę samą godzinę (12:00) — to był artefakt danych sprzed przebudowy licznika, a nie wasze zwyczaje. Teraz pokazuje prawdziwe godziny, a komu ich nie znamy, temu nie zmyśla

0.1.1 — Pius I

papież nr 10 z 267, pontyfikat 140-155

komendy mówią teraz, co pokazują — !korona na pustych danych tłumaczy, co się w niej pojawi, zamiast samego "za mało danych"
!ja pisze "między 12:00 a 13:00" zamiast "o 12:00" — bo to godzina, a nie moment

Releases older than the ten most recent live in DOCS-changelog-archive.md. Nothing reads them: announce caps a backlog at ten releases, and since() resolves the floor from the version ladder rather than from this file, so a group that has been quiet for twenty releases still gets the ten newest that are here. Moved when this file crossed the shared 250-line cap; keep doing that rather than letting it grow.

11 KiB Raw Blame History