@leemour/cli-messaging 0.97.0 → 0.99.0

package/parity.json

@@ -1,4 +1,5 @@
 {
+  "clis": ["max", "tg"],
   "options": {
     "--add": {
       "value": "<chat>",
@@ -19,6 +20,9 @@
     "--all": {
       "meaning": "every row, no paging"
     },
+    "--all-bots": {
+      "meaning": "also read every other bot's copy on this machine that readOtherBots allows"
+    },
     "--all-can-pin": {
       "value": "<on|off>",
       "meaning": "every member may pin messages"
@@ -63,6 +67,10 @@
     "--background": {
       "meaning": "run as a job that outlives this command; `store jobs show` follows it"
     },
+    "--batch": {
+      "value": "<id>",
+      "meaning": "the batch id `conversations batches next` printed"
+    },
     "--before-id": {
       "value": "<id>",
       "meaning": "read what came before this message id; not with --before-time"
@@ -75,9 +83,17 @@
       "value": "<time>",
       "meaning": "read what came before this ISO 8601 time, or 2h / 1d ago; not with --before-id"
     },
+    "--block": {
+      "value": "<value>",
+      "meaning": "Set to `true` if user should be blocked in chat."
+    },
     "--bot": {
       "meaning": "the bot section of the profile's settings, rather than the personal account's"
     },
+    "--bots": {
+      "value": "<profiles>",
+      "meaning": "also read these bots' copies, comma separated — each allowed by readOtherBots"
+    },
     "--can": {
       "value": "<rights>",
       "meaning": "what they may do, comma-separated: read, members, admins, info, pin, link, post, edit, delete",
@@ -92,12 +108,17 @@
       "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"
+      "meaning": "say whether a newer version exists, and install nothing",
+      "note": "`bot list --check` names the messenger until both CLIs take the release after 0.98.0, where it says \"the messenger\"; then this note goes"
     },
     "--confirm-send": {
       "meaning": "show the owner every write the MCP server offers, in a form to approve",
       "note": "max's own `mcp` is worded differently until the permission levels (P7) replace these flags there (e13)"
     },
+    "--context": {
+      "value": "<n>",
+      "meaning": "messages before and after each hit"
+    },
     "--defaults": {
       "meaning": "change what every profile gets, rather than this profile"
     },
@@ -142,9 +163,16 @@
       "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)"
     },
+    "--from": {
+      "value": "<value>",
+      "meaning": "Start time for requested messages - use after instead"
+    },
     "--history": {
       "meaning": "the people added also see the messages from before they came"
     },
+    "--html": {
+      "meaning": "the text is HTML: <b>, <i>, <a href>, <code>"
+    },
     "--idle": {
       "value": "<duration>",
       "meaning": "stop after this long with nobody using it — 15m, 1h"
@@ -187,16 +215,15 @@
     "--mark-read": {
       "meaning": "also mark the chat read up to the newest message shown; the other person sees it"
     },
+    "--marker": {
+      "value": "<value>",
+      "meaning": "Marker"
+    },
     "--max-actions": {
       "value": "<n>",
       "meaning": "at most this many actions in one run",
       "default": "10"
     },
-    "--max-pages": {
-      "value": "<n>",
-      "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"
     },
@@ -215,6 +242,12 @@
     "--new": {
       "meaning": "what arrived since the last check, each message once — for scheduled runs"
     },
+    "--newest": {
+      "meaning": "newest first instead of best first"
+    },
+    "--no-ban": {
+      "meaning": "remove without banning; by default a removed person cannot come back by the link"
+    },
     "--no-preview": {
       "meaning": "no preview card for a link in the text"
     },
@@ -224,6 +257,10 @@
     "--no-serve": {
       "meaning": "do not start it; log in on this command's own connection unless one is running"
     },
+    "--notification": {
+      "value": "<text>",
+      "meaning": "a note only the person who pressed sees"
+    },
     "--notify": {
       "meaning": "tell the chat's members about the pin"
     },
@@ -270,7 +307,8 @@
     },
     "--page-size": {
       "value": "<n>",
-      "meaning": "how many items one request to the messenger asks for; the messenger's own if not given"
+      "meaning": "how many items one request to the messenger asks for; the messenger's own if not given",
+      "note": "the default is each messenger's own page: 30 on MAX, 100 on Telegram"
     },
     "--pause": {
       "value": "<duration>",
@@ -297,6 +335,9 @@
       "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 — one request"
+    },
     "--regex": {
       "meaning": "the words are one regular expression, case-insensitive, tested against every stored text"
     },
@@ -322,6 +363,9 @@
       "value": "<text>",
       "meaning": "only chats whose name contains this; at least 3 characters"
     },
+    "--secret-stdin": {
+      "meaning": "a secret MAX sends back in X-Max-Bot-Api-Secret — asked for, or read from a pipe"
+    },
     "--send-id": {
       "value": "<id>",
       "meaning": "reuse the id of an earlier send whose outcome is unknown; the messenger drops the duplicate"
@@ -344,6 +388,18 @@
       "value": "<time>",
       "meaning": "from this ISO 8601 time, or 2h / 1d ago; each command says its default"
     },
+    "--size": {
+      "value": "<n>",
+      "meaning": "messages to answer per batch, 10–200; 50 by default"
+    },
+    "--source": {
+      "value": "<messenger>",
+      "meaning": "every account of this messenger held in the store, or all of them — the same as in: in the query"
+    },
+    "--text": {
+      "value": "<text>",
+      "meaning": "the message's new text; - reads stdin"
+    },
     "--timeout": {
       "value": "<duration>",
       "meaning": "give up on the whole command after this — 30s, 2m, 500ms"
@@ -369,6 +425,10 @@
       "value": "<names>",
       "meaning": "only events of these types, comma-separated, as the messenger names them"
     },
+    "--types": {
+      "value": "<value>",
+      "meaning": "Comma separated list of update types your bot want to receive"
+    },
     "--unanswered": {
       "value": "[duration]",
       "meaning": "only questions to you or a group's admins that nobody answered, asked at least this long ago — 4h, 1d",
@@ -398,872 +458,1559 @@
     }
   },
   "globalOptions": {
-    "--json": "both",
-    "--jsonl": "both",
-    "--no-record": "both",
+    "--json": "all",
+    "--jsonl": "all",
+    "--no-record": "all",
     "--no-serve": {
-      "state": "planned",
-      "by": "P6"
+      "in": [],
+      "planned": {
+        "max": "P6",
+        "tg": "P6"
+      }
     },
-    "--offline": "both",
-    "--quiet": "both",
-    "--record": "both",
+    "--offline": "all",
+    "--quiet": "all",
+    "--record": "all",
     "--serve": {
-      "state": "planned",
-      "by": "P6"
+      "in": [],
+      "planned": {
+        "max": "P6",
+        "tg": "P6"
+      }
     },
-    "--timeout": "both",
-    "--trace": "both",
-    "--verbose": "both",
-    "--version": "both",
+    "--timeout": "all",
+    "--trace": "all",
+    "--verbose": "all",
+    "--version": "all",
     "--yes": {
-      "state": "planned",
-      "by": "P7"
+      "in": [],
+      "planned": {
+        "max": "P7",
+        "tg": "P7"
+      }
     }
   },
   "commands": {
     "account": {
-      "state": "both"
+      "in": "all"
     },
     "account sessions": {
-      "state": "both"
+      "in": "all"
     },
     "account sessions end": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--others": "both",
+        "--others": "all",
         "--yes": {
-          "state": "planned",
-          "by": "P2"
+          "in": [],
+          "planned": {
+            "max": "P2",
+            "tg": "P2"
+          }
         }
       }
     },
     "account sessions list": {
-      "state": "both"
+      "in": "all"
     },
     "account show": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--show-phone": "both"
+        "--show-phone": "all"
       }
     },
     "account update": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--description": "both",
-        "--first-name": "both",
-        "--last-name": "both",
-        "--photo": "both"
+        "--description": "all",
+        "--first-name": "all",
+        "--last-name": "all",
+        "--photo": "all"
       }
     },
     "bot": {
-      "state": "planned",
-      "by": "P8",
-      "subtree": true
+      "in": "all"
+    },
+    "bot api": {
+      "in": ["max"],
+      "reason": "MAX's own Bot API operations, generated from MAX's schema; a generated `bot api` for Telegram comes after P8"
+    },
+    "bot auth": {
+      "in": "all"
+    },
+    "bot auth remove": {
+      "in": "all"
+    },
+    "bot auth set": {
+      "in": "all"
+    },
+    "bot auth show": {
+      "in": "all"
+    },
+    "bot callbacks": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot callbacks answer": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--notification": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--text": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot chats": {
+      "in": "all"
+    },
+    "bot chats action": {
+      "in": "all"
+    },
+    "bot chats admins": {
+      "in": "all"
+    },
+    "bot chats admins add": {
+      "in": "all",
+      "options": {
+        "--can": "all",
+        "--title": "all"
+      }
+    },
+    "bot chats admins list": {
+      "in": "all"
+    },
+    "bot chats admins remove": {
+      "in": "all"
+    },
+    "bot chats check": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-dangerous": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--dry-run": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--max-actions": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--no-ban": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--since": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot chats leave": {
+      "in": "all"
+    },
+    "bot chats list": {
+      "in": "all"
+    },
+    "bot chats members": {
+      "in": "all"
+    },
+    "bot chats members add": {
+      "in": ["max"],
+      "reason": "a Telegram bot cannot add people to a chat"
+    },
+    "bot chats members list": {
+      "in": ["max"],
+      "options": {
+        "--limit": {
+          "in": ["max"],
+          "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+        },
+        "--marker": {
+          "in": ["max"],
+          "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+        }
+      },
+      "reason": "Telegram's Bot API cannot list a chat's members, only its admins and a count"
+    },
+    "bot chats members remove": {
+      "in": "all",
+      "options": {
+        "--block": "all"
+      }
+    },
+    "bot chats rules": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules show": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats rules unset": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot chats show": {
+      "in": "all"
+    },
+    "bot commands": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands clear": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands list": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot commands set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot comments": {
+      "in": ["max"],
+      "reason": "a Telegram channel's comments are messages in a separate discussion group, reached by ids only an update gives"
+    },
+    "bot list": {
+      "in": "all",
+      "options": {
+        "--check": "all"
+      }
+    },
+    "bot mcp": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-delete": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-moderate": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--confirm-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot mcp config": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--allow-delete": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-moderate": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--allow-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--confirm-send": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot me": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot messages": {
+      "in": "all"
+    },
+    "bot messages between": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot messages delete": {
+      "in": "all",
+      "options": {
+        "--allow-dangerous": "all"
+      }
+    },
+    "bot messages edit": {
+      "in": "all",
+      "options": {
+        "--html": "all",
+        "--md": "all"
+      }
+    },
+    "bot messages list": {
+      "in": "all",
+      "options": {
+        "--limit": "all"
+      }
+    },
+    "bot messages pin": {
+      "in": "all",
+      "options": {
+        "--notify": "all"
+      }
+    },
+    "bot messages search": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--from": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot messages send": {
+      "in": "all",
+      "options": {
+        "--allow-any-file": "all",
+        "--as-file": "all",
+        "--file": "all",
+        "--html": "all",
+        "--md": "all",
+        "--photo": "all",
+        "--reply-to": "all",
+        "--silent": "all",
+        "--voice": "all"
+      }
+    },
+    "bot messages show": {
+      "in": "all"
+    },
+    "bot messages unpin": {
+      "in": "all"
+    },
+    "bot people": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot people show": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--all-bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--bots": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--limit": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--refresh": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot recipients": {
+      "in": "all"
+    },
+    "bot recipients add": {
+      "in": "all"
+    },
+    "bot recipients clear": {
+      "in": "all"
+    },
+    "bot recipients list": {
+      "in": "all"
+    },
+    "bot recipients remove": {
+      "in": "all"
+    },
+    "bot sends": {
+      "in": "all"
+    },
+    "bot sends list": {
+      "in": "all"
+    },
+    "bot updates": {
+      "in": [],
+      "planned": {
+        "max": "P8 B4: becomes bot watch",
+        "tg": "P8"
+      }
+    },
+    "bot updates watch": {
+      "in": [],
+      "planned": {
+        "max": "P8 B4: becomes bot watch",
+        "tg": "P8"
+      },
+      "options": {
+        "--types": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: becomes bot watch",
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot uploads": {
+      "in": ["max"],
+      "reason": "Telegram has no upload-only step: a file goes up with the message that carries it"
+    },
+    "bot watch": {
+      "in": [],
+      "planned": {
+        "max": "P8 B4: max's bot watch comes with its move to the shared one",
+        "tg": "P8"
+      },
+      "options": {
+        "--events": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: max's bot watch comes with its move to the shared one",
+            "tg": "P8"
+          }
+        },
+        "--types": {
+          "in": [],
+          "planned": {
+            "max": "P8 B4: max's bot watch comes with its move to the shared one",
+            "tg": "P8"
+          }
+        }
+      }
+    },
+    "bot webhooks": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks delete": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks list": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      }
+    },
+    "bot webhooks set": {
+      "in": ["max"],
+      "planned": {
+        "tg": "P8"
+      },
+      "options": {
+        "--add": {
+          "in": ["max"],
+          "reason": "a Telegram bot holds one webhook address"
+        },
+        "--secret-stdin": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        },
+        "--types": {
+          "in": ["max"],
+          "planned": {
+            "tg": "P8"
+          }
+        }
+      }
     },
     "cache": {
-      "state": "max-only",
+      "in": ["max"],
       "reason": "max's local cache, removed when the store replaces it (T6 group 6); tg never had one"
     },
     "chats": {
-      "state": "both"
+      "in": "all"
     },
     "chats admins": {
-      "state": "both"
+      "in": "all"
     },
     "chats admins add": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--can": "both"
+        "--can": "all"
       }
     },
     "chats admins remove": {
-      "state": "both"
+      "in": "all"
     },
     "chats check": {
-      "state": "max-only",
+      "in": ["max"],
       "reason": "named chats moderate by the standard (check changes nothing); max keeps the old name until T6 moves the command"
     },
     "chats create": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--channel": "both"
+        "--channel": "all"
       }
     },
     "chats events": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--event": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's own copy keeps the old name until T6 moves the command onto the shared one"
         },
         "--since": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's own copy keeps the old name until T6 moves the command onto the shared one"
         },
         "--since-time": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--type": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         }
       }
     },
     "chats folders": {
-      "state": "both"
+      "in": "all"
     },
     "chats folders create": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--chat": "both"
+        "--chat": "all"
       }
     },
     "chats folders delete": {
-      "state": "both"
+      "in": "all"
     },
     "chats folders list": {
-      "state": "both"
+      "in": "all"
     },
     "chats folders update": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--add": "both",
-        "--remove": "both",
-        "--title": "both"
+        "--add": "all",
+        "--remove": "all",
+        "--title": "all"
       }
     },
     "chats inspect": {
-      "state": "both"
+      "in": "all"
     },
     "chats join": {
-      "state": "both"
+      "in": "all"
     },
     "chats leave": {
-      "state": "both"
+      "in": "all"
     },
     "chats link": {
-      "state": "both"
+      "in": "all"
     },
     "chats link reset": {
-      "state": "both"
+      "in": "all"
     },
     "chats link show": {
-      "state": "both"
+      "in": "all"
     },
     "chats list": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--all": "both",
-        "--kind": "both",
-        "--limit": "both",
-        "--page": "both",
-        "--search": "both",
-        "--unread": "both"
+        "--all": "all",
+        "--kind": "all",
+        "--limit": "all",
+        "--page": "all",
+        "--search": "all",
+        "--unread": "all"
       }
     },
     "chats mark-read": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--until": "both"
+        "--until": "all"
       }
     },
     "chats members": {
-      "state": "both"
+      "in": "all"
     },
     "chats members add": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--history": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "Telegram shows history to new members only in legacy groups, and P2 makes supergroups"
         }
       }
     },
     "chats members list": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--all": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--limit": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--page": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         }
       }
     },
     "chats members remove": {
-      "state": "both"
+      "in": "all"
     },
     "chats moderate": {
-      "state": "planned",
-      "by": "P2",
+      "in": [],
+      "planned": {
+        "max": "P2",
+        "tg": "P2"
+      },
       "options": {
         "--allow-dangerous": {
-          "state": "planned",
-          "by": "P2"
+          "in": [],
+          "planned": {
+            "max": "P2",
+            "tg": "P2"
+          }
         },
         "--dry-run": {
-          "state": "planned",
-          "by": "P2"
+          "in": [],
+          "planned": {
+            "max": "P2",
+            "tg": "P2"
+          }
         },
         "--max-actions": {
-          "state": "planned",
-          "by": "P2"
+          "in": [],
+          "planned": {
+            "max": "P2",
+            "tg": "P2"
+          }
         },
         "--since-time": {
-          "state": "planned",
-          "by": "P2"
+          "in": [],
+          "planned": {
+            "max": "P2",
+            "tg": "P2"
+          }
         }
       }
     },
     "chats rules": {
-      "state": "both"
+      "in": "all"
     },
     "chats rules set": {
-      "state": "both"
+      "in": "all"
     },
     "chats rules show": {
-      "state": "both"
+      "in": "all"
     },
     "chats rules unset": {
-      "state": "both"
+      "in": "all"
     },
     "chats show": {
-      "state": "both"
+      "in": "all"
     },
     "chats update": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--all-can-pin": "both",
-        "--description": "both",
+        "--all-can-pin": "all",
+        "--description": "all",
         "--members-see-link": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "Telegram shows a group's invite link to whoever may invite, not by a setting of its own"
         },
-        "--only-admins-add": "both",
+        "--only-admins-add": "all",
         "--only-admins-call": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "Telegram has no setting for who may start a call"
         },
         "--only-owner-edits-info": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "Telegram lets admins with the right change the info, never only the owner; a different meaning gets a different name"
         },
-        "--title": "both"
+        "--title": "all"
       }
     },
     "commands": {
-      "state": "both"
+      "in": "all"
     },
     "complete": {
-      "state": "both"
+      "in": "all"
     },
     "config": {
-      "state": "both"
+      "in": "all"
     },
     "config set": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--bot": {
-          "state": "planned",
-          "by": "P8"
+          "in": [],
+          "planned": {
+            "max": "P8",
+            "tg": "P8"
+          }
         },
-        "--defaults": "both",
+        "--defaults": "all",
         "--personal": {
-          "state": "planned",
-          "by": "P8"
+          "in": [],
+          "planned": {
+            "max": "P8",
+            "tg": "P8"
+          }
         }
       }
     },
     "config show": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--bot": {
-          "state": "planned",
-          "by": "P8"
+          "in": [],
+          "planned": {
+            "max": "P8",
+            "tg": "P8"
+          }
         }
       }
     },
     "config unset": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--bot": {
-          "state": "planned",
-          "by": "P8"
+          "in": [],
+          "planned": {
+            "max": "P8",
+            "tg": "P8"
+          }
         },
-        "--defaults": "both",
+        "--defaults": "all",
         "--personal": {
-          "state": "planned",
-          "by": "P8"
+          "in": [],
+          "planned": {
+            "max": "P8",
+            "tg": "P8"
+          }
         }
       }
     },
     "contacts": {
-      "state": "both"
+      "in": "all"
     },
     "contacts add": {
-      "state": "both"
+      "in": "all"
     },
     "contacts block": {
-      "state": "both"
+      "in": "all"
     },
     "contacts import": {
-      "state": "both"
+      "in": "all"
     },
     "contacts list": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--all": "both",
-        "--limit": "both",
-        "--order": "both",
-        "--page": "both",
-        "--search": "both"
+        "--all": "all",
+        "--limit": "all",
+        "--order": "all",
+        "--page": "all",
+        "--search": "all"
       }
     },
     "contacts lookup": {
-      "state": "both"
+      "in": "all"
     },
     "contacts remove": {
-      "state": "both"
+      "in": "all"
     },
     "contacts rename": {
-      "state": "both"
+      "in": "all"
     },
     "contacts show": {
-      "state": "both"
+      "in": "all"
     },
     "contacts sync": {
-      "state": "both"
+      "in": "all"
     },
     "contacts unblock": {
-      "state": "both"
+      "in": "all"
     },
     "conversations": {
-      "state": "planned",
-      "by": "max: reads onto messages.db",
-      "subtree": true
+      "in": "all"
+    },
+    "conversations batches": {
+      "in": "all"
+    },
+    "conversations batches next": {
+      "in": "all",
+      "options": {
+        "--chat": "all",
+        "--size": "all"
+      }
+    },
+    "conversations batches status": {
+      "in": "all",
+      "options": {
+        "--chat": "all",
+        "--size": "all"
+      }
+    },
+    "conversations build": {
+      "in": "all",
+      "options": {
+        "--chat": "all"
+      }
+    },
+    "conversations links": {
+      "in": ["max"],
+      "planned": {
+        "tg": "tg: cli-messaging 0.97.0 bump"
+      }
+    },
+    "conversations links add": {
+      "in": ["max"],
+      "planned": {
+        "tg": "tg: cli-messaging 0.97.0 bump"
+      },
+      "options": {
+        "--batch": {
+          "in": ["max"],
+          "planned": {
+            "tg": "tg: cli-messaging 0.97.0 bump"
+          }
+        }
+      }
+    },
+    "conversations links clear": {
+      "in": ["max"],
+      "planned": {
+        "tg": "tg: cli-messaging 0.97.0 bump"
+      },
+      "options": {
+        "--chat": {
+          "in": ["max"],
+          "planned": {
+            "tg": "tg: cli-messaging 0.97.0 bump"
+          }
+        },
+        "--model": {
+          "in": ["max"],
+          "planned": {
+            "tg": "tg: cli-messaging 0.97.0 bump"
+          }
+        }
+      }
+    },
+    "conversations list": {
+      "in": "all",
+      "options": {
+        "--chat": "all",
+        "--limit": "all",
+        "--since-time": "all"
+      }
+    },
+    "conversations show": {
+      "in": "all"
     },
     "doctor": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--online": "both"
+        "--online": "all"
       }
     },
     "doctor report": {
-      "state": "both"
+      "in": "all"
     },
     "doctor report create": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--output": "both",
-        "--run": "both"
+        "--output": "all",
+        "--run": "all"
       }
     },
     "inbox": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--all": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
-        "--limit": "both",
-        "--model": "both",
-        "--new": "both",
+        "--limit": "all",
+        "--model": "all",
+        "--new": "all",
         "--since": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's own copy keeps the old name until T6 moves the command onto the shared one"
         },
         "--since-time": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
-        "--transcribe": "both"
+        "--transcribe": "all"
       }
     },
     "mcp": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--allow-dangerous": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         },
-        "--allow-delete": "both",
-        "--allow-mark-read": "both",
+        "--allow-delete": "all",
+        "--allow-mark-read": "all",
         "--allow-moderate": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         },
-        "--allow-send": "both",
-        "--confirm-send": "both",
+        "--allow-send": "all",
+        "--confirm-send": "all",
         "--yes": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         }
       }
     },
     "mcp config": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--allow-dangerous": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         },
-        "--allow-delete": "both",
-        "--allow-mark-read": "both",
+        "--allow-delete": "all",
+        "--allow-mark-read": "all",
         "--allow-moderate": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         },
-        "--allow-send": "both",
-        "--confirm-send": "both",
+        "--allow-send": "all",
+        "--confirm-send": "all",
         "--yes": {
-          "state": "planned",
-          "by": "P7"
+          "in": [],
+          "planned": {
+            "max": "P7",
+            "tg": "P7"
+          }
         }
       }
     },
     "messages": {
-      "state": "both"
+      "in": "all"
     },
     "messages context": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--after-n": "both",
-        "--before-n": "both"
+        "--after-n": "all",
+        "--before-n": "all"
       }
     },
     "messages delete": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--allow-dangerous": "both",
-        "--for-everyone": "both"
+        "--allow-dangerous": "all",
+        "--for-everyone": "all"
       }
     },
     "messages download": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--all": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--output": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's own copy keeps the old name until T6 moves the command onto the shared one"
         },
         "--output-dir": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--pause": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         }
       }
     },
     "messages edit": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--md": "both"
+        "--md": "all"
       }
     },
     "messages forward": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--send-id": "both",
-        "--silent": "both",
-        "--to": "both"
+        "--send-id": "all",
+        "--silent": "all",
+        "--to": "all"
       }
     },
     "messages links": {
-      "state": "planned",
-      "by": "max: reads onto messages.db"
+      "in": "all"
     },
     "messages list": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--after-id": "both",
-        "--after-time": "both",
-        "--before-id": "both",
-        "--before-time": "both",
-        "--limit": "both",
-        "--mark-read": "both",
-        "--model": "both",
-        "--transcribe": "both"
+        "--after-id": "all",
+        "--after-time": "all",
+        "--before-id": "all",
+        "--before-time": "all",
+        "--limit": "all",
+        "--mark-read": "all",
+        "--model": "all",
+        "--transcribe": "all"
       }
     },
     "messages pin": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--notify": "both"
+        "--notify": "all"
       }
     },
     "messages scheduled": {
-      "state": "both"
+      "in": "all"
     },
     "messages search": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--chat": "both",
-        "--limit": "both",
+        "--chat": "all",
+        "--context": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
+        },
+        "--limit": "all",
+        "--newest": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
+        },
         "--regex": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
+        },
+        "--source": {
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-messaging bump with phase 2",
+            "tg": "each CLI's cli-messaging bump with phase 2"
+          }
         }
       }
     },
     "messages send": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--allow-any-file": "both",
-        "--as-file": "both",
-        "--at-time": "both",
-        "--file": "both",
-        "--md": "both",
-        "--no-preview": "both",
-        "--photo": "both",
-        "--reply-to": "both",
-        "--send-id": "both",
-        "--silent": "both",
-        "--voice": "both"
+        "--allow-any-file": "all",
+        "--as-file": "all",
+        "--at-time": "all",
+        "--file": "all",
+        "--md": "all",
+        "--no-preview": "all",
+        "--photo": "all",
+        "--reply-to": "all",
+        "--send-id": "all",
+        "--silent": "all",
+        "--voice": "all"
       }
     },
     "messages show": {
-      "state": "both"
+      "in": "all"
     },
     "messages transcribe": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--local": {
-          "state": "tg-only",
+          "in": ["tg"],
           "reason": "Telegram can transcribe on its side; MAX cannot, so max always uses the local model"
         },
-        "--model": "both"
+        "--model": "all"
       }
     },
     "messages unpin": {
-      "state": "both"
+      "in": "all"
     },
     "models": {
-      "state": "both"
+      "in": "all"
     },
     "models audio": {
-      "state": "both"
+      "in": "all"
     },
     "models audio download": {
-      "state": "both"
+      "in": "all"
     },
     "models audio list": {
-      "state": "both"
+      "in": "all"
+    },
+    "models text": {
+      "in": [],
+      "planned": {
+        "max": "storage phase 5: the cli-messaging bump after it ships",
+        "tg": "storage phase 5: the cli-messaging bump after it ships"
+      },
+      "subtree": true
     },
     "polls": {
-      "state": "both"
+      "in": "all"
     },
     "polls close": {
-      "state": "both"
+      "in": "all"
     },
     "polls create": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--anonymous": "both",
-        "--multiple": "both",
-        "--revote": "both",
-        "--send-id": "both",
-        "--silent": "both"
+        "--anonymous": "all",
+        "--multiple": "all",
+        "--revote": "all",
+        "--send-id": "all",
+        "--silent": "all"
       }
     },
     "polls show": {
-      "state": "both"
+      "in": "all"
     },
     "polls vote": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--retract": "both"
+        "--retract": "all"
       }
     },
     "reactions": {
-      "state": "both"
+      "in": "all"
     },
     "reactions add": {
-      "state": "both"
+      "in": "all"
     },
     "reactions remove": {
-      "state": "both"
+      "in": "all"
     },
     "recipients": {
-      "state": "both"
+      "in": "all"
     },
     "recipients add": {
-      "state": "both"
+      "in": "all"
     },
     "recipients clear": {
-      "state": "both"
+      "in": "all"
     },
     "recipients list": {
-      "state": "both"
+      "in": "all"
     },
     "recipients remove": {
-      "state": "both"
+      "in": "all"
     },
     "review": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--all": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
-        "--chat": "both",
+        "--chat": "all",
         "--model": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
         "--since": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's own copy keeps the old name until T6 moves the command onto the shared one"
         },
         "--since-time": {
-          "state": "planned",
-          "by": "T6"
+          "in": [],
+          "planned": {
+            "max": "T6",
+            "tg": "T6"
+          }
         },
-        "--transcribe": "both",
-        "--unanswered": "both"
+        "--transcribe": "all",
+        "--unanswered": "all"
       }
     },
     "runs": {
-      "state": "both"
+      "in": "all"
     },
     "runs list": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--limit": "both"
+        "--limit": "all"
       }
     },
     "runs path": {
-      "state": "both"
+      "in": "all"
     },
     "runs show": {
-      "state": "both"
+      "in": "all"
     },
     "sends": {
-      "state": "both"
+      "in": "all"
     },
     "sends list": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--limit": "both"
+        "--limit": "all"
       }
     },
     "serve": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--idle": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's server stops when no command has used it for this long; tg's serve has no commands connected to it (NEED-495 A)"
         }
       }
     },
     "server": {
-      "state": "both"
+      "in": "all"
     },
     "server install": {
-      "state": "both"
+      "in": "all"
     },
     "server logs": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--lines": "both"
+        "--lines": "all"
       }
     },
     "server restart": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--idle": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's server stops when no command has used it for this long; tg's serve has no commands connected to it (NEED-495 A)"
         }
       }
     },
     "server start": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--idle": {
-          "state": "max-only",
+          "in": ["max"],
           "reason": "max's server stops when no command has used it for this long; tg's serve has no commands connected to it (NEED-495 A)"
         }
       }
     },
     "server status": {
-      "state": "both"
+      "in": "all"
     },
     "server stop": {
-      "state": "both"
+      "in": "all"
     },
     "server uninstall": {
-      "state": "both"
+      "in": "all"
     },
     "session": {
-      "state": "both"
+      "in": "all"
     },
     "session end": {
-      "state": "both"
+      "in": "all"
     },
     "session start": {
-      "state": "both",
+      "in": "all",
       "options": {
         "--app": {
-          "state": "tg-only",
+          "in": ["tg"],
           "reason": "Telegram asks each client for its own app from my.telegram.org; MAX has no such step"
         },
         "--qr-file": {
-          "state": "tg-only",
+          "in": ["tg"],
           "reason": "ruled tg-only with the app registration it belongs to"
         }
       }
     },
     "skill": {
-      "state": "both"
+      "in": "all"
     },
     "skill install": {
-      "state": "planned",
-      "by": "each CLI's cli-core 0.11.0 bump",
+      "in": [],
+      "planned": {
+        "max": "each CLI's cli-core 0.11.0 bump",
+        "tg": "each CLI's cli-core 0.11.0 bump"
+      },
       "options": {
         "--for": {
-          "state": "planned",
-          "by": "each CLI's cli-core 0.11.0 bump"
+          "in": [],
+          "planned": {
+            "max": "each CLI's cli-core 0.11.0 bump",
+            "tg": "each CLI's cli-core 0.11.0 bump"
+          }
         }
       }
     },
     "skill show": {
-      "state": "both"
+      "in": "all"
     },
     "store": {
-      "state": "both"
+      "in": "all"
     },
     "store backup": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store check": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store clear": {
-      "state": "planned",
-      "by": "T6",
+      "in": "all",
       "options": {
-        "--allow-dangerous": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--left": {
-          "state": "planned",
-          "by": "T6"
-        }
+        "--allow-dangerous": "all",
+        "--left": "all"
       }
     },
     "store export": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--format": "both",
-        "--output": "both",
-        "--since": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--since-time": {
-          "state": "planned",
-          "by": "T6"
-        }
+        "--format": "all",
+        "--output": "all",
+        "--since-time": "all"
       }
     },
     "store fetch": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--background": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--estimate": "both",
-        "--last": "both",
-        "--limit": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--max-pages": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--page-size": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--pause": "both",
-        "--since": {
-          "state": "planned",
-          "by": "T6"
-        },
-        "--since-time": {
-          "state": "planned",
-          "by": "T6"
-        }
+        "--background": "all",
+        "--estimate": "all",
+        "--last": "all",
+        "--limit": "all",
+        "--page-size": "all",
+        "--pause": "all",
+        "--since-time": "all"
       }
     },
     "store info": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store jobs": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store jobs cancel": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store jobs list": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store jobs show": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store migrate": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store reindex": {
-      "state": "planned",
-      "by": "T6"
+      "in": ["max"],
+      "planned": {
+        "tg": "tg: cli-messaging 0.97.0 bump"
+      }
     },
     "store restore": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "store status": {
-      "state": "planned",
-      "by": "T6"
+      "in": "all"
     },
     "topics": {
-      "state": "tg-only",
+      "in": ["tg"],
       "reason": "MAX has no forum topics"
     },
     "upgrade": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--check": "both"
+        "--check": "all"
       }
     },
     "watch": {
-      "state": "both",
+      "in": "all",
       "options": {
-        "--events": "both"
+        "--events": "all"
       }
     }
   }