@leemour/cli-messaging 0.175.0 → 0.177.0

package/parity.json

@@ -56,7 +56,7 @@
       "note": "retired access flag: accepted with a warning, grants no permissions in either CLI"
     },
     "--allow-moderate": {
-      "meaning": "offer the tool that applies a group's rules \u2014 delete others' messages, remove people",
+      "meaning": "offer the tool that applies a group's rules — delete others' messages, remove people",
       "note": "retired access flag: accepted with a warning, grants no permissions in either CLI"
     },
     "--allow-people": {
@@ -76,6 +76,10 @@
     "--anonymous": {
       "meaning": "nobody sees who voted for what"
     },
+    "--answerer": {
+      "value": "<id>",
+      "meaning": "a scoped human identity whose explicit reply qualifies; repeat it for more"
+    },
     "--app": {
       "value": "<how>",
       "meaning": "the first time only: how to get this profile's app from my.telegram.org",
@@ -86,7 +90,7 @@
     },
     "--as": {
       "value": "<state>",
-      "meaning": "how a task is closed: done, or dismissed \u2014 it needs no answer"
+      "meaning": "how a task is closed: done, or dismissed — it needs no answer"
     },
     "--as-file": {
       "meaning": "send every --file as a plain file to download, a video included"
@@ -138,7 +142,7 @@
     },
     "--bots": {
       "value": "<profiles>",
-      "meaning": "also read these bots' copies, comma separated \u2014 each allowed by readOtherBots"
+      "meaning": "also read these bots' copies, comma separated — each allowed by readOtherBots"
     },
     "--budget": {
       "value": "<pages>",
@@ -147,12 +151,12 @@
     "--by": {
       "value": "<grouping>",
       "meaning": "what to count by",
-      "note": "each command names its own groupings \u2014 stats messages show chat, sender, day or hour, and searches create the same for stats messages show --saved; stats chats show day or week, as a series beside its totals \u2014 so it differs on purpose (Help text rule 4)"
+      "note": "each command names its own groupings — stats messages show chat, sender, day or hour, and searches create the same for stats messages show --saved; stats chats show day or week, as a series beside its totals — so it differs on purpose (Help text rule 4)"
     },
     "--can": {
       "value": "<rights>",
       "meaning": "what they may do, comma-separated: read, members, admins, info, pin, link, post, edit, delete",
-      "note": "lists the rights each messenger has \u2014 MAX has `read`, Telegram does not \u2014 so it differs on purpose (Help text rule 4)"
+      "note": "lists the rights each messenger has — MAX has `read`, Telegram does not — so it differs on purpose (Help text rule 4)"
     },
     "--caption-above": {
       "meaning": "show the text above the --photo or --file, not below it"
@@ -233,7 +237,7 @@
     },
     "--deep": {
       "value": "<n>",
-      "meaning": "also check the top n in full \u2014 profile, photos, everything they wrote, and the public ban lists, which are sent their ids \u2014 one person a second",
+      "meaning": "also check the top n in full — profile, photos, everything they wrote, and the public ban lists, which are sent their ids — one person a second",
       "note": "TG specializes the SDK help with the bounded Telegram audit; MAX retains the generic SDK wording. Align the shared help with provider capabilities separately; SDK adoption alone does not remove the difference."
     },
     "--defaults": {
@@ -249,11 +253,11 @@
     },
     "--description": {
       "value": "<text>",
-      "meaning": "the new about text \u2014 of a chat or of your account"
+      "meaning": "the new about text — of a chat or of your account"
     },
     "--dims": {
       "value": "<n>",
-      "meaning": "remote: the vector size \u2014 needed with --base-url; shortens an OpenAI model's"
+      "meaning": "remote: the vector size — needed with --base-url; shortens an OpenAI model's"
     },
     "--do": {
       "meaning": "actions: reply, task, or both, comma-separated",
@@ -266,6 +270,10 @@
       "meaning": "judge and plan; do nothing",
       "note": "A command-specific dry run keeps its richer plan; otherwise the shared shell previews arguments and permissions without running the action. Targets remain unresolved unless that command provides a preview."
     },
+    "--emoji": {
+      "value": "<emoji>",
+      "meaning": "the folder's icon"
+    },
     "--encrypt": {
       "meaning": "compress and encrypt with a password, typed at a hidden prompt or piped on stdin; never kept"
     },
@@ -280,6 +288,10 @@
     "--exact": {
       "meaning": "bare words and quotes match their exact form only, as exact:word does; text: still matches every form"
     },
+    "--exclude-chat": {
+      "value": "<chat>",
+      "meaning": "never show this chat in the folder; repeat it for more"
+    },
     "--expire-time": {
       "value": "<time>",
       "meaning": "it stops working then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now"
@@ -317,7 +329,7 @@
       "default": "all"
     },
     "--for-everyone": {
-      "meaning": "delete for everyone in the chat, not only for you \u2014 they cannot get it back"
+      "meaning": "delete for everyone in the chat, not only for you — they cannot get it back"
     },
     "--format": {
       "value": "<format>",
@@ -344,7 +356,7 @@
     },
     "--http": {
       "meaning": "serve MCP over HTTP on 127.0.0.1 behind the owner's tunnel, with a one-owner login; every write asks first by default",
-      "note": "MAX wording catches up with Telegram\u2019s explicit \u201cby default\u201d at the next shared SDK adoption; both HTTP servers confirm writes by default"
+      "note": "MAX wording catches up with Telegram’s explicit “by default” at the next shared SDK adoption; both HTTP servers confirm writes by default"
     },
     "--http-confirmation": {
       "value": "<mode>",
@@ -353,7 +365,11 @@
     },
     "--idle": {
       "value": "<duration>",
-      "meaning": "stop after this long with nobody using it \u2014 15m, 1h"
+      "meaning": "stop after this long with nobody using it — 15m, 1h"
+    },
+    "--include": {
+      "value": "<kinds>",
+      "meaning": "a folder takes every chat of these kinds: contacts, non-contacts, groups, channels, bots"
     },
     "--join-approval": {
       "value": "<on|off>",
@@ -444,6 +460,10 @@
       "meaning": "at most this many serialized bytes of machine data; 0 disables the bound",
       "default": "4194304"
     },
+    "--max-replies": {
+      "value": "<n>",
+      "meaning": "maximum observed discussion replies"
+    },
     "--max-tokens": {
       "value": "<n>",
       "meaning": "remote embeddings: bound input tokens; analysis: reserve input and output tokens across this run"
@@ -488,6 +508,10 @@
       "value": "<n>",
       "meaning": "only rows scoring at least this"
     },
+    "--min-views": {
+      "value": "<n>",
+      "meaning": "minimum known cumulative views"
+    },
     "--model": {
       "value": "<id>",
       "meaning": "which downloaded speech model hears them; `models audio list` shows them",
@@ -500,7 +524,7 @@
       "meaning": "only files saved here whose text nobody has yet: what an agent reads and writes back"
     },
     "--new": {
-      "meaning": "what arrived since the last check, each message once \u2014 for scheduled runs"
+      "meaning": "what arrived since the last check, each message once — for scheduled runs"
     },
     "--newest": {
       "meaning": "newest first instead of best first"
@@ -566,6 +590,10 @@
     "--offline": {
       "meaning": "answer from what was recorded and never connect; fails if nothing was"
     },
+    "--older-than": {
+      "value": "<duration>",
+      "meaning": "minimum age of a question without an observed qualifying answer"
+    },
     "--online": {
       "meaning": "also log in once, read one chat and start the MCP server; sends nothing",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
@@ -593,7 +621,7 @@
     "--output": {
       "meaning": "where to write: a directory for `messages download`, a file for `store export`",
       "default": ".",
-      "note": "MAX `messages download --output <dir>` remains a compatibility alias for `--output-dir`; other commands use --output for a file \u2014 e10"
+      "note": "MAX `messages download --output <dir>` remains a compatibility alias for `--output-dir`; other commands use --output for a file — e10"
     },
     "--output-dir": {
       "value": "<dir>",
@@ -641,7 +669,11 @@
     },
     "--photo": {
       "value": "<file>",
-      "meaning": "an image file \u2014 a profile photo in `account update`, a photo to send in `messages send`"
+      "meaning": "an image file — a profile photo in `account update`, a group's photo in `chats update`, a photo to send in `messages send`"
+    },
+    "--pin": {
+      "value": "<chat>",
+      "meaning": "pin this chat at the top of the folder; repeat it for more"
     },
     "--pinned": {
       "value": "<on|off>",
@@ -672,14 +704,14 @@
     },
     "--reason": {
       "value": "<text>",
-      "meaning": "why a task was closed, kept with it \u2014 no-reply-needed, for example"
+      "meaning": "why a task was closed, kept with it — no-reply-needed, for example"
     },
     "--record": {
-      "meaning": "keep this run under `runs` \u2014 ids and timings, never message content",
+      "meaning": "keep this run under `runs` — ids and timings, never message content",
       "note": "max's own copy is worded differently until T6 moves the command onto the shared one (e13)"
     },
     "--refresh": {
-      "meaning": "read the private chat with them from MAX first \u2014 one request",
+      "meaning": "read the private chat with them from MAX first — one request",
       "note": "one idea, two sources: bring what the answer is read from up to date first. `bot contacts show` reads the private chat again from the messenger; `conversations search` builds and embeds, on this machine, the chats that changed (NEED-551 A, awaiting the owner's wording)"
     },
     "--refresh-metadata": {
@@ -744,7 +776,7 @@
       "meaning": "only people whose private notes contain this text"
     },
     "--secret-stdin": {
-      "meaning": "a secret MAX sends back in X-Max-Bot-Api-Secret \u2014 asked for, or read from a pipe"
+      "meaning": "a secret MAX sends back in X-Max-Bot-Api-Secret — asked for, or read from a pipe"
     },
     "--selection": {
       "value": "<json>",
@@ -774,7 +806,7 @@
     "--since": {
       "value": "<id-or-time>",
       "meaning": "from this message id, an ISO 8601 time, or 2h / 1d ago; each command says its default",
-      "note": "becomes `--since-time` everywhere \u2014 NEED-485"
+      "note": "becomes `--since-time` everywhere — NEED-485"
     },
     "--since-time": {
       "value": "<time>",
@@ -782,11 +814,15 @@
     },
     "--size": {
       "value": "<n>",
-      "meaning": "messages to answer per batch, 10\u2013200; 50 by default"
+      "meaning": "messages to answer per batch, 10–200; 50 by default"
+    },
+    "--skip": {
+      "value": "<which>",
+      "meaning": "a folder leaves out chats that are muted, read or archived"
     },
     "--source": {
       "value": "<messenger>",
-      "meaning": "every account of this messenger held in the store; personal, bots or all \u2014 the same as in: in the query"
+      "meaning": "every account of this messenger held in the store; personal, bots or all — the same as in: in the query"
     },
     "--spoiler": {
       "meaning": "hide the --photo or video behind a spoiler until tapped"
@@ -848,7 +884,7 @@
     },
     "--timeout": {
       "value": "<duration>",
-      "meaning": "give up on the whole command after this \u2014 30s, 2m, 500ms"
+      "meaning": "give up on the whole command after this — 30s, 2m, 500ms"
     },
     "--timezone": {
       "value": "<zone>",
@@ -858,7 +894,7 @@
     },
     "--title": {
       "value": "<title>",
-      "meaning": "the new name \u2014 of a chat, a folder or a forum topic"
+      "meaning": "the new name — of a chat, a folder or a forum topic"
     },
     "--to": {
       "value": "<chat>",
@@ -884,7 +920,7 @@
     "--type": {
       "value": "<names>",
       "meaning": "only these types",
-      "note": "each command names its own types \u2014 chats events the messenger's event types, comma-separated, as it names them; tags list chat, contact or message; tasks list question, request, mention or promise, and tasks add gives the new task one of them \u2014 so it differs on purpose (Help text rule 4)"
+      "note": "each command names its own types — chats events the messenger's event types, comma-separated, as it names them; tags list chat, contact or message; tasks list question, request, mention or promise, and tasks add gives the new task one of them — so it differs on purpose (Help text rule 4)"
     },
     "--types": {
       "value": "<value>",
@@ -892,7 +928,7 @@
     },
     "--unanswered": {
       "value": "[duration]",
-      "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago \u2014 4h, 1d",
+      "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d",
       "note": "max's own `review` still takes bare hours until T6 moves it (e2)",
       "default": "24h"
     },
@@ -903,6 +939,10 @@
       "value": "<message>",
       "meaning": "only up to this message id, inclusive; the newest by default"
     },
+    "--until-time": {
+      "value": "<time>",
+      "meaning": "through this ISO 8601 time, or 2h / 1d ago"
+    },
     "--upgrade": {
       "meaning": "explicitly upgrade a basic group to a supergroup before enabling topics; its chat id changes"
     },
@@ -924,6 +964,10 @@
     "--with-notes": {
       "meaning": "include your private notes, subject to contacts.notes.list permission"
     },
+    "--within": {
+      "value": "<duration>",
+      "meaning": "the help window after a known newcomer join"
+    },
     "--words": {
       "meaning": "match any of these whole words, comma-separated; empty clears",
       "value": "<words>"
@@ -1417,7 +1461,32 @@
     "chats folders create": {
       "in": "all",
       "options": {
-        "--chat": "all"
+        "--chat": "all",
+        "--emoji": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--exclude-chat": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--include": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--pin": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--skip": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        }
       }
     },
     "chats folders delete": {
@@ -1434,17 +1503,41 @@
       "in": "all"
     },
     "chats folders order": {
-      "in": [],
-      "reason": "max-cli does not map folder order yet",
+      "in": ["tg"],
       "planned": {
-        "tg": "feat/folders-order-join"
+        "max": "feat/client-gaps-a"
       }
     },
     "chats folders update": {
       "in": "all",
       "options": {
         "--add": "all",
+        "--emoji": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--exclude-chat": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--include": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
+        "--pin": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
         "--remove": "all",
+        "--skip": {
+          "in": [],
+          "reason": "max-cli folders hold only the chats named in them",
+          "planned": { "tg": "feat/folder-rules" }
+        },
         "--title": "all"
       }
     },
@@ -1737,6 +1830,13 @@
           "in": ["max"],
           "reason": "Telegram lets admins with the right change the info, never only the owner; a different meaning gets a different name"
         },
+        "--photo": {
+          "in": [],
+          "planned": {
+            "max": "feat/client-gaps-photo",
+            "tg": "tg-cli backlog: chats update --photo"
+          }
+        },
         "--title": "all"
       }
     },
@@ -3077,6 +3177,21 @@
     "stats chats": {
       "in": "all"
     },
+    "stats chats newcomers": {
+      "in": [],
+      "planned": {
+        "max": "Admin statistics adoption",
+        "tg": "Admin statistics adoption"
+      },
+      "options": {
+        "--answerer": "all",
+        "--limit": "all",
+        "--since-time": "all",
+        "--timezone": "all",
+        "--until-time": "all",
+        "--within": "all"
+      }
+    },
     "stats chats official": {
       "in": ["tg"],
       "reason": "MAX has no statistics request of its own for a chat"
@@ -3107,6 +3222,21 @@
         "--selection": "all"
       }
     },
+    "stats contacts responses": {
+      "in": [],
+      "planned": {
+        "max": "Admin statistics adoption",
+        "tg": "Admin statistics adoption"
+      },
+      "options": {
+        "--answerer": "all",
+        "--chat": "all",
+        "--exact": "all",
+        "--limit": "all",
+        "--source": "all",
+        "--timezone": "all"
+      }
+    },
     "stats contacts top": {
       "in": "all",
       "options": {
@@ -3130,6 +3260,22 @@
     "stats messages": {
       "in": "all"
     },
+    "stats messages discussion": {
+      "in": [],
+      "planned": {
+        "max": "Admin statistics adoption",
+        "tg": "Admin statistics adoption"
+      },
+      "options": {
+        "--chat": "all",
+        "--exact": "all",
+        "--limit": "all",
+        "--max-replies": "all",
+        "--min-views": "all",
+        "--source": "all",
+        "--timezone": "all"
+      }
+    },
     "stats messages evidence": {
       "in": "all",
       "options": {
@@ -3194,6 +3340,22 @@
         "--weights": "all"
       }
     },
+    "stats messages unanswered": {
+      "in": [],
+      "planned": {
+        "max": "Admin statistics adoption",
+        "tg": "Admin statistics adoption"
+      },
+      "options": {
+        "--answerer": "all",
+        "--chat": "all",
+        "--exact": "all",
+        "--limit": "all",
+        "--older-than": "all",
+        "--source": "all",
+        "--timezone": "all"
+      }
+    },
     "stats tasks": {
       "in": "all"
     },