@leemour/cli-messaging 0.85.0 → 0.87.0

package/parity.json

@@ -6,7 +6,20 @@
     },
     "--after": {
       "value": "<id-or-time>",
-      "meaning": "read what came after this message id, this ISO 8601 time, or 2h / 1d ago; not with --before"
+      "meaning": "read what came after this message id, this ISO 8601 time, or 2h / 1d ago; not with --before",
+      "note": "becomes `--after-id`, `--after-time` (`messages list`) and `--after-n` (`messages context`) — NEED-485"
+    },
+    "--after-id": {
+      "value": "<id>",
+      "meaning": "read what came after this message id; not with --after-time or the --before pair"
+    },
+    "--after-n": {
+      "value": "<n>",
+      "meaning": "how many messages after it"
+    },
+    "--after-time": {
+      "value": "<time>",
+      "meaning": "read what came after this ISO 8601 time, or 2h / 1d ago; not with --after-id or the --before pair"
     },
     "--all": {
       "meaning": "every row, no paging"
@@ -55,7 +68,19 @@
     "--before": {
       "value": "<id-or-time>",
       "meaning": "read what came before this message id, this ISO 8601 time, or 2h / 1d ago",
-      "note": "tg's `messages list` spells the value `<id>`"
+      "note": "becomes `--before-id`, `--before-time` (`messages list`) and `--before-n` (`messages context`) — NEED-485"
+    },
+    "--before-id": {
+      "value": "<id>",
+      "meaning": "read what came before this message id; not with --before-time"
+    },
+    "--before-n": {
+      "value": "<n>",
+      "meaning": "how many messages before it"
+    },
+    "--before-time": {
+      "value": "<time>",
+      "meaning": "read what came before this ISO 8601 time, or 2h / 1d ago; not with --before-id"
     },
     "--bot": {
       "meaning": "the bot section of the profile's settings, rather than the personal account's"
@@ -70,7 +95,7 @@
     "--chat": {
       "value": "<chat>",
       "meaning": "a chat, by id or name; repeat it for more",
-      "note": "tg's `messages search` spells the value `<id>`; rule 6 says `<chat>`"
+      "note": "max's `messages search` takes `<id>` only, since searching never connects to resolve a name; rule 6 says `<chat>` (e8)"
     },
     "--check": {
       "meaning": "say whether a newer version exists, and install nothing"
@@ -96,13 +121,15 @@
     },
     "--event": {
       "value": "<names>",
-      "meaning": "only these events, comma-separated, as the messenger names them"
+      "meaning": "only these events, comma-separated, as the messenger names them",
+      "note": "becomes `--type` — e12"
     },
     "--events": {
-      "meaning": "also print edits, deletions and reactions; every line then names its event"
+      "meaning": "also print edits, deletions and reactions; every line then names its event",
+      "note": "differs by one letter from `chats events --event`, a filter with an unrelated meaning (e12)"
     },
     "--file": {
-      "value": "<path>",
+      "value": "<file>",
       "meaning": "attach a file; images go as a photo, videos as a video. Repeat it for more"
     },
     "--first-name": {
@@ -114,14 +141,15 @@
     },
     "--format": {
       "value": "<format>",
-      "meaning": "jsonl or md"
+      "meaning": "jsonl, one message per line, or a markdown transcript",
+      "note": "the shared `store export` takes `jsonl` or `markdown`, max's own takes `jsonl` or `md` (e4)"
     },
     "--history": {
       "meaning": "the people added also see the messages from before they came"
     },
     "--idle": {
       "value": "<duration>",
-      "meaning": "stop after this long with nobody using it — 15m, 1h is 60m"
+      "meaning": "stop after this long with nobody using it — 15m, 1h"
     },
     "--json": {
       "meaning": "machine-readable output: one JSON value on stdout, nothing else"
@@ -131,8 +159,7 @@
     },
     "--kind": {
       "value": "<kind>",
-      "meaning": "only chats of this kind: dialog, group or channel",
-      "note": "max spells the value `<dialog|group|channel>`; the choices belong in the description"
+      "meaning": "only chats of this kind: dialog, group, channel or saved"
     },
     "--last": {
       "value": "<n>",
@@ -144,7 +171,7 @@
     },
     "--limit": {
       "value": "<n>",
-      "meaning": "how many to show"
+      "meaning": "how many: rows to show, or messages one run fetches"
     },
     "--lines": {
       "value": "<n>",
@@ -164,8 +191,8 @@
     },
     "--max-pages": {
       "value": "<n>",
-      "meaning": "at most this many pages of 100 messages in one run",
-      "default": "10"
+      "meaning": "at most this many pages in one run; a page is one request, and each messenger sets the default",
+      "note": "replaced by `--limit` (messages per run) and `--page-size` — NEED-486"
     },
     "--md": {
       "meaning": "read **bold**, _italic_, ~~struck~~ and `code` in the text; \\ keeps a mark literal"
@@ -224,12 +251,21 @@
     "--output": {
       "meaning": "where to write: a directory for `messages download`, a file for `store export`",
       "default": ".",
-      "note": "clash: `<dir>` in one command, `<file>` in another"
+      "note": "`messages download --output <dir>` becomes `--output-dir`; `--output` stays a file — e10"
+    },
+    "--output-dir": {
+      "value": "<dir>",
+      "meaning": "the folder to write into, created if missing",
+      "default": "."
     },
     "--page": {
       "value": "<n>",
       "meaning": "which page, starting at 1"
     },
+    "--page-size": {
+      "value": "<n>",
+      "meaning": "how many items one request to the messenger asks for; the messenger's own if not given"
+    },
     "--pause": {
       "value": "<duration>",
       "meaning": "the least wait between pages, 5s or 500ms; each is up to twice that",
@@ -240,8 +276,7 @@
     },
     "--photo": {
       "value": "<file>",
-      "meaning": "an image file — a profile photo in `account update`, a photo to send in `messages send`",
-      "note": "tg's `messages send --photo` takes `<path>`; rule 6 says `<file>`"
+      "meaning": "an image file — a profile photo in `account update`, a photo to send in `messages send`"
     },
     "--qr-file": {
       "value": "<png>",
@@ -280,8 +315,7 @@
     },
     "--send-id": {
       "value": "<id>",
-      "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate",
-      "note": "max spells the value `<n>`"
+      "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate"
     },
     "--serve": {
       "meaning": "start `serve` in the background if it is not running (the default)"
@@ -295,7 +329,11 @@
     "--since": {
       "value": "<id-or-time>",
       "meaning": "from this message id, an ISO 8601 time, or 2h / 1d ago; each command says its default",
-      "note": "the shared `chats events`, `store fetch`, `store export`, `inbox` and `review` take `<time>` only, never a message id: a Telegram id is a counter within one chat"
+      "note": "becomes `--since-time` everywhere — NEED-485"
+    },
+    "--since-time": {
+      "value": "<time>",
+      "meaning": "from this ISO 8601 time, or 2h / 1d ago; each command says its default"
     },
     "--stop": {
       "meaning": "stop this profile's server — the same as `server stop`"
@@ -318,9 +356,15 @@
     "--transcribe": {
       "meaning": "hear voice messages not heard yet, on this machine; slow, the model must be downloaded"
     },
+    "--type": {
+      "value": "<names>",
+      "meaning": "only events of these types, comma-separated, as the messenger names them"
+    },
     "--unanswered": {
-      "value": "[hours]",
-      "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago; 24 hours if not given"
+      "value": "[duration]",
+      "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"
     },
     "--unread": {
       "meaning": "only chats with unread messages"
@@ -338,8 +382,7 @@
     },
     "--voice": {
       "value": "<file>",
-      "meaning": "send an Ogg Opus file as a voice message, alone, with no text",
-      "note": "max spells the value `<path>`; rule 6 says `<file>`"
+      "meaning": "send an Ogg Opus file as a voice message, alone, with no text"
     },
     "--yes": {
       "meaning": "go ahead without the question an ask level puts before a write"
@@ -423,16 +466,12 @@
     },
     "bot": {
       "state": "planned",
-      "by": "tg bot — not scheduled",
+      "by": "P8",
       "subtree": true
     },
     "cache": {
-      "state": "planned",
-      "by": "T6"
-    },
-    "cache clear": {
-      "state": "planned",
-      "by": "T6"
+      "state": "max-only",
+      "reason": "max's local cache, removed when the store replaces it (T6 group 6); tg never had one"
     },
     "chats": {
       "state": "both"
@@ -462,48 +501,45 @@
     "chats events": {
       "state": "both",
       "options": {
-        "--event": "both",
-        "--since": "both"
+        "--event": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--type": {
+          "state": "planned",
+          "by": "P0b"
+        }
       }
     },
     "chats folders": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders create": {
-      "state": "planned",
-      "by": "P2",
+      "state": "both",
       "options": {
-        "--chat": {
-          "state": "planned",
-          "by": "P2"
-        }
+        "--chat": "both"
       }
     },
     "chats folders delete": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders list": {
-      "state": "planned",
-      "by": "P2"
+      "state": "both"
     },
     "chats folders update": {
-      "state": "planned",
-      "by": "P2",
+      "state": "both",
       "options": {
-        "--add": {
-          "state": "planned",
-          "by": "P2"
-        },
-        "--remove": {
-          "state": "planned",
-          "by": "P2"
-        },
-        "--title": {
-          "state": "planned",
-          "by": "P2"
-        }
+        "--add": "both",
+        "--remove": "both",
+        "--title": "both"
       }
     },
     "chats inspect": {
@@ -592,6 +628,10 @@
         "--since": {
           "state": "planned",
           "by": "P2"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
         }
       }
     },
@@ -649,12 +689,12 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         },
         "--defaults": "both",
         "--personal": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },
@@ -663,7 +703,7 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },
@@ -672,12 +712,12 @@
       "options": {
         "--bot": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         },
         "--defaults": "both",
         "--personal": {
           "state": "planned",
-          "by": "tg bot — not scheduled"
+          "by": "P8"
         }
       }
     },
@@ -753,7 +793,14 @@
         "--limit": "both",
         "--model": "both",
         "--new": "both",
-        "--since": "both",
+        "--since": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
+        },
         "--transcribe": "both"
       }
     },
@@ -805,8 +852,22 @@
     "messages context": {
       "state": "both",
       "options": {
-        "--after": "both",
-        "--before": "both"
+        "--after": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--after-n": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--before": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--before-n": {
+          "state": "planned",
+          "by": "P0b"
+        }
       }
     },
     "messages delete": {
@@ -823,7 +884,14 @@
           "state": "planned",
           "by": "T6"
         },
-        "--output": "both",
+        "--output": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--output-dir": {
+          "state": "planned",
+          "by": "P0b"
+        },
         "--pause": {
           "state": "planned",
           "by": "T6"
@@ -847,8 +915,30 @@
     "messages list": {
       "state": "both",
       "options": {
-        "--after": "both",
-        "--before": "both",
+        "--after": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--after-id": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--after-time": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--before": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--before-id": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--before-time": {
+          "state": "planned",
+          "by": "P0b"
+        },
         "--limit": "both",
         "--mark-read": "both",
         "--model": "both",
@@ -980,7 +1070,14 @@
           "state": "planned",
           "by": "T6"
         },
-        "--since": "both",
+        "--since": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
+        },
         "--transcribe": "both",
         "--unanswered": "both"
       }
@@ -1112,7 +1209,14 @@
       "options": {
         "--format": "both",
         "--output": "both",
-        "--since": "both"
+        "--since": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
+        }
       }
     },
     "store fetch": {
@@ -1124,9 +1228,27 @@
         },
         "--estimate": "both",
         "--last": "both",
-        "--max-pages": "both",
+        "--limit": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--max-pages": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--page-size": {
+          "state": "planned",
+          "by": "P0b"
+        },
         "--pause": "both",
-        "--since": "both"
+        "--since": {
+          "state": "planned",
+          "by": "P0b"
+        },
+        "--since-time": {
+          "state": "planned",
+          "by": "P0b"
+        }
       }
     },
     "store info": {