umputun / tg-spam
83%

DEFAULT BRANCH: master
Repo Added
Files 41
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

LAST BUILD ON BRANCH master
branch: SELECT
CHANGE BRANCH
x

coverage: 83.419% (+0.1%) from 83.275%
25134669663

push

github

web-flow 
feat: short-message flood detection for unapproved users (#400)

* docs(claude): add wiring-layers checklist for new config parameters

Codifies the requirement that any new configurable parameter (CLI flag, env
var, or tunable knob) must be wired through CLI/env definition, DB-backed
config, web settings UI, e2e UI test, and README. Recurring source of
partially-broken features when one layer is missed.

* feat: add max-short-msg-count short-message flood detection

Adds an opt-in spam check that bans an unapproved user when their locator
message count minus approved count crosses --max-short-msg-count, and the
current message is short. Closes the gap left by content-based checks for
spammers probing the channel with innocuous one-word messages ("hi",
"hello", "yo") that individually evade similarity, classifier, LLM, and
duplicate detectors.

State is derived from the existing messages table via the
idx_messages_gid_user_id_time index — no new in-memory counter, no cache,
restart-resilient by construction. The check is implemented as an internal
method on Detector (isShortMsgFlood), gated by an outer guard so disabled
mode does no work, and bypasses LLM consensus by design (behavioral signal
not subject to content-based override).

Wired through all required layers per CLAUDE.md: CLI flag and env var
(--max-short-msg-count / MAX_SHORT_MSG_COUNT), DB-backed Settings with
zero-aware semantics, web settings UI form field plus read-only display,
e2e UI round-trip test, and README documentation. Respects training, dry,
and soft-ban modes via the existing pipeline. Disabled by default
(MaxShortMsgCount=0) and incompatible with paranoid mode (validated at
startup).

Related to #399

* docs(plans): max-short-msg-count implementation plan

Captures the design decisions, wiring layers, edge cases, and task
breakdown for the short-message flood detection feature. Filed under
completed/ since the implementation has landed.

Related to #399

* fix: trim README s... (continued)

95 of 97 new or added lines in 5 files covered. (97.94%)

8452 of 10132 relevant lines covered (83.42%)

227.44 hits per line

Relevant lines Covered
10132 RELEVANT LINES 8452 COVERED LINES
227.44 HITS PER LINE
Source Files on master

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
25134669663 master feat: short-message flood detection for unapproved users (#400) * docs(claude): add wiring-layers checklist for new config parameters Codifies the requirement that any new configurable parameter (CLI flag, env var, or tunable knob) must be wired... push web-flow github
83.42
25133013538 feature/max-short-msg-count-399 fix: trim README short-msg-flood section and clarify approved-user guard Two refinements from post-implementation review: - README.md: drop the trigger-formula code block, locator-derivation paragraph, separate "When triggered" paragraph, dedi... Pull #400 umputun github
83.42
25131459943 feature/max-short-msg-count-399 docs(plans): max-short-msg-count implementation plan Captures the design decisions, wiring layers, edge cases, and task breakdown for the short-message flood detection feature. Filed under completed/ since the implementation has landed. Related ... push umputun github
83.41
25123809667 master test(tgspam): cover short-message LLM ham clear vs approval counter Adds a subtest under TestDetector_ShortMessageApproval verifying that when CheckShortMessagesWithOpenAI is enabled and the LLM clears a short message as ham, the approval counter... push umputun github
83.28
25035848305 master Add warn auto-ban for repeated admin /warn commands (#398) * add plan: warn-auto-ban * feat: add Warnings storage layer for warn auto-ban Add per-event log table tracking admin /warn commands per (gid, user_id). Mirrors the Reports storage patt... push web-flow github
83.28
25035708813 warn-auto-ban fix: harden warn auto-ban against negative thresholds Address Copilot review on PR #398: - admin.go: gate warn auto-ban with `warnThreshold <= 0` instead of `== 0` to match the existing `Report.AutoBanThreshold > 0` convention. Without this,... Pull #398 umputun github
83.28
25035710228 warn-auto-ban fix: harden warn auto-ban against negative thresholds Address Copilot review on PR #398: - admin.go: gate warn auto-ban with `warnThreshold <= 0` instead of `== 0` to match the existing `Report.AutoBanThreshold > 0` convention. Without this,... Pull #398 umputun github
83.28
25035412437 warn-auto-ban test(e2e): wait for htmx settle before clicking delete TestManageSamples_DeleteSpam was racing with HTMX in headed mode: the test clicked the newly-swapped delete button before HTMX bound hx-post to it, causing the form to fall back to a native P... Pull #398 umputun github
83.27
25030940684 master Implement database configuration support (#294) * Implement database configuration support - Add generic Config storage component with type-safe configuration storage - Add CLI flag --confdb to load configuration from database - Add save-config ... push web-flow github
83.08
24966212061 feature-db-configuration fix: preserve InstanceID across loadConfigFromDB swap; rename collided subtests (#397) * fix: preserve InstanceID across loadConfigFromDB swap; rename collided subtests `loadConfigFromDB` does `*settings = *dbSettings` which clobbers the CLI/env... Pull #294 web-flow github
83.08
See All Builds (1340)