filter: advert window, path block, dry-run, sender/text rules, message age limit

dmc-docs/custom-cli.de.md

@@ -15,6 +15,7 @@ ACL-Kontaktpakete werden übersprungen. Der Zustand wird in `/filter_prefs` gesp
 - `filter help`
 - `filter on` / `filter off`
 - `filter reset`
+- `filter dryrun on|off` (Drops zählen, aber weiterhin weiterleiten; Statuszeile endet auf `(dry-run)`)
 - `filter types`
 - `filter count`
 - `filter hops <type> <max_hops>` (Typ `00`-`11`, Hops `0`-`64`)
@@ -23,7 +24,18 @@ ACL-Kontaktpakete werden übersprungen. Der Zustand wird in `/filter_prefs` gesp
 - `filter channel list|add|remove <#name|Public>` (bis zu 16, nur GRP_TXT)
 - `filter hash <min_bytes>` (1-3, minimale Path-Hash-Größe)
 - `filter malformed on|off` (UTF-8-/Strukturvalidierung von öffentlichem GRP_TXT)
-- `filter stats <topic>` mit topic = `hops|rate|hash|channel|malformed|top`
+- `filter advert <stunden>` (0-720; das Advert jedes Knotens höchstens einmal pro Fenster
+  weitergeleitet, `0` = aus) / `filter advert clear`
+- `filter path list|add|remove <hex>` (bis zu 8 Präfixe mit 2-8 Hex-Ziffern; verwirft alles,
+  was über einen Repeater mit diesem ID-Präfix kam)
+- `filter sender add <name> [secs] [prob]` / `remove` / `list` (bis zu 8; Name exakt, `Bot*` = Präfix;
+  `secs` 0 = blockieren, sonst eine Nachricht pro `secs` durchlassen; `prob` 1-100 = Anteil, den die Regel entscheidet)
+- `filter text add <muster> [secs] [prob]` / `remove` / `list` (bis zu 8; Teilstring, `^` = Nachrichtenanfang)
+- `filter watch add|remove|list <#name>` (bis zu 4 Kanäle, die die Regeln lesen dürfen, neben Public)
+- `filter age <Minuten>|off` (1-10080; verwirft Gruppennachrichten auf Public und beobachteten
+  Kanälen, die älter sind, nach der Uhr des Repeaters; inaktiv, solange die Uhr nicht gestellt ist)
+- `filter stats <topic>` mit topic = `hops|rate|hash|channel|malformed|top|advert|path|air|sender|text|age`
+  (`air` = geschätzte eingesparte Sendezeit)
 
 ### Pakettypen
 

dmc-docs/custom-cli.en.md

@@ -14,6 +14,7 @@ packets bypass it. State is persisted to `/filter_prefs`.
 - `filter help`
 - `filter on` / `filter off`
 - `filter reset`
+- `filter dryrun on|off` (count drops but keep forwarding; the status line ends in `(dry-run)`)
 - `filter types`
 - `filter count`
 - `filter hops <type> <max_hops>` (type `00`-`11`, hops `0`-`64`)
@@ -22,7 +23,18 @@ packets bypass it. State is persisted to `/filter_prefs`.
 - `filter channel list|add|remove <#name|Public>` (up to 16, GRP_TXT only)
 - `filter hash <min_bytes>` (1-3, minimum path-hash size)
 - `filter malformed on|off` (UTF-8 / structure validation of public GRP_TXT)
-- `filter stats <topic>` where topic = `hops|rate|hash|channel|malformed|top`
+- `filter advert <hours>` (0-720; each node's advert forwarded at most once per window,
+  `0` = off) / `filter advert clear`
+- `filter path list|add|remove <hex>` (up to 8 prefixes of 2-8 hex digits; drops everything
+  that came through a repeater whose ID starts with it)
+- `filter sender add <name> [secs] [prob]` / `remove` / `list` (up to 8; exact name, `Bot*` = prefix;
+  `secs` 0 = block, else pass one message per `secs`; `prob` 1-100 = share of matches the rule decides)
+- `filter text add <pattern> [secs] [prob]` / `remove` / `list` (up to 8; substring, `^` = start of message)
+- `filter watch add|remove|list <#name>` (up to 4 channels the rules may read, besides Public)
+- `filter age <minutes>|off` (1-10080; drop group texts on Public and watched channels older than
+  this, by the repeater's clock; inactive while the clock is not set)
+- `filter stats <topic>` where topic = `hops|rate|hash|channel|malformed|top|advert|path|air|sender|text|age`
+  (`air` = estimated airtime saved)
 
 ### Packet types
 

dmc-docs/custom-cli.md

@@ -15,6 +15,7 @@ ACL-contactpakketten worden overgeslagen. De status wordt bewaard in `/filter_pr
 - `filter help`
 - `filter on` / `filter off`
 - `filter reset`
+- `filter dryrun on|off` (drops tellen maar wél doorsturen; statusregel eindigt op `(dry-run)`)
 - `filter types`
 - `filter count`
 - `filter hops <type> <max_hops>` (type `00`-`11`, hops `0`-`64`)
@@ -23,7 +24,18 @@ ACL-contactpakketten worden overgeslagen. De status wordt bewaard in `/filter_pr
 - `filter channel list|add|remove <#naam|Public>` (max. 16, alleen GRP_TXT)
 - `filter hash <min_bytes>` (1-3, minimale path-hashgrootte)
 - `filter malformed on|off` (UTF-8-/structuurvalidatie van publieke GRP_TXT)
-- `filter stats <topic>` met topic = `hops|rate|hash|channel|malformed|top`
+- `filter advert <uren>` (0-720; elke node's advert hooguit één keer per venster doorgestuurd,
+  `0` = uit) / `filter advert clear`
+- `filter path list|add|remove <hex>` (max. 8 prefixen van 2-8 hexcijfers; blokkeert alles wat
+  via een repeater met dat ID-prefix kwam)
+- `filter sender add <naam> [secs] [prob]` / `remove` / `list` (max. 8; naam exact, `Bot*` = prefix;
+  `secs` 0 = blokkeren, anders 1 bericht per `secs` doorlaten; `prob` 1-100 = aandeel dat de regel beslist)
+- `filter text add <patroon> [secs] [prob]` / `remove` / `list` (max. 8; substring, `^` = begin van het bericht)
+- `filter watch add|remove|list <#naam>` (max. 4 kanalen die de regels mogen lezen, naast Public)
+- `filter age <minuten>|off` (1-10080; groepsberichten op Public en gevolgde kanalen die ouder zijn
+  dan dit worden gedropt, volgens de klok van de repeater; doet niets zolang de klok niet is gezet)
+- `filter stats <topic>` met topic = `hops|rate|hash|channel|malformed|top|advert|path|air|sender|text|age`
+  (`air` = geschatte bespaarde zendtijd)
 
 ### Pakkettypes
 

docs/cli_commands.md

@@ -211,9 +211,10 @@ Configuration and statistics are kept apart: `filter <setting>` shows and change
 - `filter on`
 - `filter off`
 - `filter reset` — restore the default settings (counters are not affected)
+- `filter dryrun` / `filter dryrun <on|off>` — count drops but keep forwarding, to size a setting before enforcing it
 - `filter types` — list the packet type IDs used by `hops`, `rate` and `count`
 
-**Note:** The filter is disabled by default. Direct-routed packets and packets involving known ACL contacts always bypass it.
+**Note:** The filter is disabled by default. Direct-routed packets and packets involving known ACL contacts always bypass it. While dry-run is on the status line ends in `(dry-run)`.
 
 ---
 
@@ -241,6 +242,11 @@ filter
 - `filter stats channel`
 - `filter stats malformed`
 - `filter stats top`
+- `filter stats advert` — drops by the per-origin advert window
+- `filter stats path` — drops per blocked path prefix
+- `filter stats air` — estimated time-on-air the drops saved (in dry-run: would have saved)
+- `filter stats sender` / `filter stats text` — drops (and throttle passes) per sender/text rule
+- `filter stats age` — group texts dropped by the message age limit (`filter age <minutes>|off`)
 
 **Example:**
 ```text