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

Krzysztof kuhy Rudnicki ca38147576 release: 0.1.4 «Eleuteriusz» — the list of commands lives in the chat now

Thirteen commands, and the only list of them was a README table nobody in a
Signal group can read — which had itself gone stale two releases earlier,
still advertising four commands after nine more had shipped. 0.1.1 gave each
command an output that says what the command is; that only helps once you
already know to type it.

!pomoc (also !pomocy, !help, !komendy, !commands) prints all fourteen,
grouped, one Polish line each.

The interesting part is that it cannot go stale. CommandRegistry.register now
takes the description as a REQUIRED argument, so a command that does not
explain itself does not compile; and render_help prints any command that
help_command.GROUPS forgot to file, under no heading, rather than dropping
it. Two independent ways to fail closed, because the README proved that a
hand-maintained second list is a list that drifts.

Command also gained `primary`, the first raw alias. The trigger set could not
supply it: those are folded skeletons in an unordered frozenset, so all that
survives of "!papież" there is "!papiez", and the styled Unicode aliases come
out as zalgo. aliases.json already lists the canonical Polish spelling first.

The full trigger table moves to DOCS-commands.md. It did not fit in README —
that file was already sitting exactly on the shared 250-line cap, and the
gate caught the overflow on the first commit attempt.

Exercised in testbot at the unbumped version before this bump: the live
dispatcher ran it and posted the list, journal clean. pytest 708 green at
100% branch coverage, e2e green including a new scenario that asserts !pomoc
mentions a command registered by a different module.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017w1HZ3cZ7neL3rFdQ6VMBA

2026-08-30 21:08:02 +02:00

4.9 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 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.

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.1.4 — Eleuteriusz

!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 — Soter

"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 — Anicet

!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

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

0.1.0 — Hygin

podsumowanie liczy teraz zdjęcia i filmy — zdjęcie bez podpisu było wcześniej warte zero, więc liczby wszystkim podskoczyły
kto nic nie napisał, pojawia się z zerem
nowe komendy: !staty, !wczoraj, !tydzień, !miesiąc, !rok, !rekordy, !korona, !dni, !ja
bot pamięta historię: rekordy życiowe, serie z koroną, średnie dni tygodnia. Liczymy od 30 sierpnia 2026

0.0.7 — Telesfor

nowa komenda !papież (działa też jako !papiez, !papa, !pope) — bot wrzuca losowego papieża: zdjęcie, imię po łacinie, lata pontyfikatu i link do polskiej Wikipedii. Do wyboru jest cała lista, 267 papieży od Świętego Piotra do Leona XIV — czyli ci sami, po których nazywają się wersje bota

0.0.6 — Sykstus I

po restarcie komputera bot wraca sam — wcześniej, jeśli włączył się zanim Signal był gotowy, poddawał się po 25 sekundach i milczał do końca dnia; 30 sierpnia stało się to na osiem godzin

0.0.5 — Aleksander I

komendy działają teraz niezależnie od tego, na jakiej klawiaturze je piszesz — !gekon napisany rosyjskimi literami (albo jako !g3ck0) wreszcie odpowiada, wcześniej bot go po prostu ignorował

0.0.4 — Ewaryst

!gekon pokazuje teraz za każdym razem innego gekona — wcześniej wrzucał w kółko to samo zdjęcie

0.0.3 — Klemens I

nowa komenda !gekon — bot wrzuca losowe zdjęcie gekona; działa też !gecko, !geckon, !geko, !gekony i !geckos

0.0.2 — Anaklet

bot odpowiada teraz na konkretną wiadomość, cytując ją — w ruchliwej rozmowie widać, czyje !cat to jest

0.0.1 — Linus

wersje bota nazywają się teraz imionami kolejnych papieży
po aktualizacji bot ogłasza w grupie nową wersję i listę zmian
/healthz pokazuje wersję i papieża, więc widać co naprawdę działa

0.0.0 — Święty Piotr Apostoł

bot taki, jaki był przed drabinką papieską: !cat, !dog i dzienne podsumowanie

4.9 KiB Raw Blame History