umputun / tg-spam / 28848461549

84%

Build Type

push

github

Committed by web-flow

Commit Message

feat: add mention-only meta check (#424)

new spam pattern showed up: a message that is just a mention and a number, like `@blah 3`. There was no "mention-only" check before (only a mention *count* check and a link-only check), so this adds one.

**what it does**

`--meta.mention-only` / `$META_MENTION_ONLY`, off by default. When enabled, a message that is nothing but @mentions plus trivial content (digits, whitespace or punctuation, in any position) is flagged as spam. Gated on at least one mention, so a bare number with no mention is never flagged. Legit replies like `@john thanks` keep a real word in the residue and pass.

modeled on the existing `LinkOnlyCheck`. Wired through every layer per the CLAUDE.md checklist: CLI/env, DB-backed `Settings` + `IsMetaEnabled`, the web settings UI form round-trip, and detector registration. Unit, handler, and e2e-ui coverage added.

**known limitations** (in the godoc, surfaced during review)

- only literal `@name` mentions are stripped, so a `text_mention` (a display-name mention with no `@`) is not caught
- the check sees `req.Msg` as built upstream, which includes quoted/reply-to text, so a mention-only message posted next to a quote is not flagged. Same as the other `*-only` checks.

also drops the legacy `unfuck-ai-comments` step from CLAUDE.md.

Coverage Stats

20 of 23 new or added lines in 5 files covered. (86.96%)

2 existing lines in 1 file now uncovered.

8581 of 10270 relevant lines covered (83.55%)

245.29 hits per line