taler-monitoring/VERSIONS.md

VERSIONS — taler-monitoring

Release history for the standalone taler-monitoring suite
(https://git.hacktivism.ch/hernani/taler-monitoring).

Version scheme

Tags and VERSION use MAJOR.FEATURE.FIX (three components), introduced in v1.4.0:

Part	Meaning
MAJOR	Breaking changes to CLI, layout, or host-agent contract
FEATURE	New capabilities (phases, HTML features, i18n packs, …)
FIX	Bugfixes and docs that do not add a feature

Git tags: vMAJOR.FEATURE.FIX (e.g. v1.7.5). File VERSION omits the v prefix.

Tag	Date (UTC)	Notes
v1.8.0	planned	L10n packs for user-facing strings: fr-CH (FrancPaysan) and de-CH (hacktivism / Taler CH German).
v1.7.6	2026-07-18	monpages obligatory (ERROR): GOA checks full suite inventory (bank/exchange/taler /monitoring/ + surface/aptdeploy/mattermost/mail + on-disk discovery); FP only its own mon hosts; MONPAGES_REQUIRE_PUBLIC=1 default (escape hatch =0). Bugfix: with_timeout no longer re-runs a phase when it exits non-zero.
v1.7.5	2026-07-18	Bugfix: monpages soft mode MONPAGES_REQUIRE_PUBLIC=0 (FP wrappers default) — missing public HTML is WARN until vhost publish; generic publish hints.
v1.7.4	2026-07-18	Bugfix: monpages bare URLs (/monitoring without /) WARN by default (trailing slash remains ERROR); avoids false red when slash form is live.
v1.7.3	2026-07-18	Monitoring pages themselves as suite scope: README section + sticky “What this monitors” block (monpages / public HTML paths).
v1.7.2	2026-07-18	Bugfix: Caddy static handles — root must be host dir + matcher /monitoring* (not leaf dir + /monitoring/), else file_server returns empty 404 after apply.
v1.7.1	2026-07-18	Host-agent default STRICT_EXIT=1; monpages staging-vs-public diagnosis; re-htmlify after public check fails.
v1.7.0	2026-07-18	CLI --ver / --version / -V: suite version, git commit, repo/tag/commit URLs.
v1.6.0	2026-07-18	Mail monitoring: phase mail (firefly + pixel/TSA); MX/SMTP/IMAP/SPF/DMARC; /taler-monitoring-mail*.
v1.5.0	2026-07-18	Mattermost monitoring: phase mattermost for mattermost.taler.net; /taler-monitoring-mattermost*.
v1.4.1	2026-07-18	Generic docs (no client hostnames); canonical install path ~/src/taler-monitoring.
v1.4.0	2026-07-18	MAJOR.FEATURE.FIX version scheme formalized (three-component tags + VERSION file).
v1.3.4	2026-07-18	Summary i18n, monpages code-21 detection, aptdeploy rsync path.
v1.3.3	2026-07-18	GIT notes vs GUI notes; monpages in TESTS.
v1.3.2	2026-07-18	Suite paths only ~/src/taler-monitoring (no admin-log suite tree).
v1.3.1	2026-07-18	monpages FQDN check + deploy no longer silent-skip.
v1.3.0	2026-07-18	Sticky bar suite version + Forgejo tag link.
v1.2.0	2026-07-18	Language selection: --lang / TALER_MON_LANG (en|fr).
v1.1.0	2026-07-18	i18n chrome: English default; French for FrancPaysan.
v1.0.0	2026-07-18	Initial standalone release.

Sticky bar version (v1.3.0+)

Generated HTML shows the installed release tag (e.g. v1.7.6) and links to Forgejo:

https://git.hacktivism.ch/hernani/taler-monitoring/src/tag/<tag>

Resolved via git describe --tags / VERSION.

Public monitoring pages (v1.3.1+)

Publish under DEPLOY_WWW_ROOT and Caddy handles. Missing handles → merchant JSON code 21.
See koopa-admin-log issue I-09 / apply-monitoring-live.sh.

Check	How
Phase	./taler-monitoring.sh monpages
CLI version	./taler-monitoring.sh --ver

Language (v1.2.0+)

Method	Example
CLI	./taler-monitoring.sh --lang fr …
Env	TALER_MON_LANG=en or fr
Auto	*lefrancpaysan* → fr, else en

Full locale packs (fr-CH / de-CH): v1.8.0 (planned).

Pin a release

git clone https://git.hacktivism.ch/hernani/taler-monitoring.git ~/src/taler-monitoring
cd ~/src/taler-monitoring && git checkout v1.7.6