@leemour/cli-messaging 0.165.0 → 0.167.0

package/parity.json

@@ -189,6 +189,14 @@
       "value": "<on|off>",
       "meaning": "on closes a forum topic to new messages, off reopens it"
     },
+    "--comment-to": {
+      "value": "<post>",
+      "meaning": "comment on this channel post; the comment goes to the post's discussion group"
+    },
+    "--component": {
+      "value": "<name>",
+      "meaning": "the ranking component whose contributing messages or answer pairs to read"
+    },
     "--concurrency": {
       "value": "<n>",
       "meaning": "remote: requests at once (default: 4)"
@@ -210,7 +218,7 @@
     },
     "--cursor": {
       "value": "<cursor>",
-      "meaning": "continue from the extraction cursor"
+      "meaning": "continue from the extraction or ranking-evidence cursor"
     },
     "--days": {
       "meaning": "days of the working window, such as mon-fri or sat,sun",
@@ -424,6 +432,10 @@
     "--md": {
       "meaning": "read this messenger's Markdown; see its formatting guide for supported syntax"
     },
+    "--measure": {
+      "value": "<name>",
+      "meaning": "the metric used to order a ranking; not with --score or --weights"
+    },
     "--members-see-link": {
       "value": "<on|off>",
       "meaning": "members may see the invite link"
@@ -435,10 +447,20 @@
       "value": "<message>",
       "meaning": "the message to tag or untag: its id in --chat, or a msg: locator alone"
     },
+    "--message-kind": {
+      "value": "<all|posts|comments>",
+      "meaning": "the proven kind of messages selected before ranking",
+      "default": "all"
+    },
     "--method": {
       "value": "<method>",
       "meaning": "how to log in when there is no session"
     },
+    "--min-messages": {
+      "value": "<n>",
+      "meaning": "minimum selected messages for a ranked author",
+      "default": "1; 5 for engaging unless explicitly set"
+    },
     "--min-score": {
       "value": "<n>",
       "meaning": "only rows scoring at least this"
@@ -515,6 +537,9 @@
     "--notify": {
       "meaning": "tell the chat's members about the pin"
     },
+    "--ocr": {
+      "meaning": "explicitly call models.ocr for bulk image and scanned-PDF text extraction; agents normally transcribe files themselves"
+    },
     "--offline": {
       "meaning": "answer from what was recorded and never connect; fails if nothing was"
     },
@@ -673,6 +698,10 @@
       "value": "<name|id>",
       "meaning": "run a saved search, or an earlier run by its id; options typed with it replace its own, more words are AND-ed"
     },
+    "--score": {
+      "value": "<helpful|active|engaging>",
+      "meaning": "the named ranking score preset; not with an explicit --measure"
+    },
     "--search": {
       "value": "<text>",
       "meaning": "only chats whose name contains this; at least 3 characters"
@@ -680,9 +709,13 @@
     "--secret-stdin": {
       "meaning": "a secret MAX sends back in X-Max-Bot-Api-Secret \u2014 asked for, or read from a pipe"
     },
+    "--selection": {
+      "value": "<json>",
+      "meaning": "the versioned resolved ranking selection returned by drilldown; authorisation is checked again"
+    },
     "--send-as": {
       "value": "<id>",
-      "meaning": "send as one of the identities `chats send-as` lists for the chat; refused where the messenger has none"
+      "meaning": "send as one of the identities `chats send-as` lists for the chat; required where the chat posts as someone else by default, refused where the messenger has none"
     },
     "--send-id": {
       "value": "<id>",
@@ -784,7 +817,7 @@
     },
     "--title": {
       "value": "<title>",
-      "meaning": "the new name — of a chat, a folder or a forum topic"
+      "meaning": "the new name \u2014 of a chat, a folder or a forum topic"
     },
     "--to": {
       "value": "<chat>",
@@ -843,6 +876,10 @@
       "value": "<file>",
       "meaning": "send an Ogg Opus file as a voice message, alone, with no text"
     },
+    "--weights": {
+      "value": "<json>",
+      "meaning": "the complete ranking component weights; replaces preset weights when --score is given"
+    },
     "--words": {
       "meaning": "match any of these whole words, comma-separated; empty clears",
       "value": "<words>"
@@ -934,26 +971,28 @@
         "--chat": {
           "in": "all"
         },
-        "--cursor": {
+        "--concurrency": {
           "in": [],
           "planned": {
-            "max": "search follow-up SDK adoption",
-            "tg": "search follow-up SDK adoption"
+            "max": "OCR",
+            "tg": "OCR"
           }
         },
+        "--cursor": "all",
         "--download": {
           "in": "all"
         },
-        "--from-dir": {
+        "--from-dir": "all",
+        "--limit": {
+          "in": "all"
+        },
+        "--ocr": {
           "in": [],
           "planned": {
-            "max": "search follow-up SDK adoption",
-            "tg": "search follow-up SDK adoption"
+            "max": "OCR",
+            "tg": "OCR"
           }
         },
-        "--limit": {
-          "in": "all"
-        },
         "--output-dir": {
           "in": "all"
         }
@@ -1533,7 +1572,9 @@
     "chats send-as": {
       "in": [],
       "reason": "MAX has no identities to post as other than the account itself",
-      "planned": { "tg": "G1 feat/send-as-identities" }
+      "planned": {
+        "tg": "G1 feat/send-as-identities"
+      }
     },
     "chats show": {
       "in": "all"
@@ -2193,6 +2234,23 @@
     "messages": {
       "in": "all"
     },
+    "messages comments": {
+      "in": [],
+      "reason": "MAX personal accounts have no channel comments; MAX's comments are a Bot API path",
+      "planned": { "tg": "G2 feat/channel-comments" },
+      "options": {
+        "--before-id": {
+          "in": [],
+          "reason": "MAX personal accounts have no channel comments",
+          "planned": { "tg": "G2 feat/channel-comments" }
+        },
+        "--limit": {
+          "in": [],
+          "reason": "MAX personal accounts have no channel comments",
+          "planned": { "tg": "G2 feat/channel-comments" }
+        }
+      }
+    },
     "messages context": {
       "in": "all",
       "options": {
@@ -2228,13 +2286,7 @@
         "--all": {
           "in": "all"
         },
-        "--extract": {
-          "in": [],
-          "planned": {
-            "max": "search follow-up SDK adoption",
-            "tg": "search follow-up SDK adoption"
-          }
-        },
+        "--extract": "all",
         "--output": {
           "in": ["max"],
           "reason": "MAX retains --output as a compatibility alias for --output-dir after shared adoption"
@@ -2265,7 +2317,10 @@
       "options": {
         "--send-as": {
           "in": [],
-          "planned": { "max": "G1 feat/send-as-identities", "tg": "G1 feat/send-as-identities" }
+          "planned": {
+            "max": "G1 feat/send-as-identities",
+            "tg": "G1 feat/send-as-identities"
+          }
         },
         "--send-id": "all",
         "--silent": "all",
@@ -2359,7 +2414,13 @@
         "--caption-above": {
           "in": [],
           "reason": "MAX has no spoilers or caption placement",
-          "planned": { "tg": "G1 feat/media-options" }
+          "planned": {
+            "tg": "G1 feat/media-options"
+          }
+        },
+        "--comment-to": {
+          "in": [],
+          "planned": { "max": "G2 feat/channel-comments", "tg": "G2 feat/channel-comments" }
         },
         "--file": "all",
         "--md": "all",
@@ -2368,14 +2429,19 @@
         "--reply-to": "all",
         "--send-as": {
           "in": [],
-          "planned": { "max": "G1 feat/send-as-identities", "tg": "G1 feat/send-as-identities" }
+          "planned": {
+            "max": "G1 feat/send-as-identities",
+            "tg": "G1 feat/send-as-identities"
+          }
         },
         "--send-id": "all",
         "--silent": "all",
         "--spoiler": {
           "in": [],
           "reason": "MAX has no spoilers or caption placement",
-          "planned": { "tg": "G1 feat/media-options" }
+          "planned": {
+            "tg": "G1 feat/media-options"
+          }
         },
         "--topic": "all",
         "--voice": "all"
@@ -2444,7 +2510,10 @@
         "--revote": "all",
         "--send-as": {
           "in": [],
-          "planned": { "max": "G1 feat/send-as-identities", "tg": "G1 feat/send-as-identities" }
+          "planned": {
+            "max": "G1 feat/send-as-identities",
+            "tg": "G1 feat/send-as-identities"
+          }
         },
         "--send-id": "all",
         "--silent": "all",
@@ -2870,20 +2939,201 @@
     "stats contacts": {
       "in": [],
       "planned": {
-        "max": "stats hierarchy migration and rankings after naming approval",
-        "tg": "stats hierarchy migration and rankings after naming approval"
+        "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+        "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+      }
+    },
+    "stats contacts evidence": {
+      "in": [],
+      "planned": {
+        "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+        "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+      },
+      "options": {
+        "--component": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--cursor": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--limit": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--selection": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        }
       }
     },
     "stats contacts top": {
       "in": [],
       "planned": {
-        "max": "stats hierarchy migration and rankings after naming approval",
-        "tg": "stats hierarchy migration and rankings after naming approval"
+        "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+        "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+      },
+      "options": {
+        "--chat": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--exact": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--limit": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--max-chats": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--max-messages": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--measure": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--message-kind": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--min-messages": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--saved": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--score": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--source": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--sync-first": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--sync-time": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--timezone": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--weights": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        }
       }
     },
     "stats messages": {
       "in": "all"
     },
+    "stats messages evidence": {
+      "in": [],
+      "planned": {
+        "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+        "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+      },
+      "options": {
+        "--component": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--cursor": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--limit": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        },
+        "--selection": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: evidence naming review, then implementation",
+            "tg": "feat/stats-rankings-contract: evidence naming review, then implementation"
+          }
+        }
+      }
+    },
     "stats messages show": {
       "in": "all",
       "options": {
@@ -2929,8 +3179,108 @@
     "stats messages top": {
       "in": [],
       "planned": {
-        "max": "stats hierarchy migration and rankings after naming approval",
-        "tg": "stats hierarchy migration and rankings after naming approval"
+        "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+        "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+      },
+      "options": {
+        "--chat": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--exact": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--limit": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--max-chats": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--max-messages": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--measure": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--message-kind": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--saved": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--score": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--source": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--sync-first": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--sync-time": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--timezone": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        },
+        "--weights": {
+          "in": [],
+          "planned": {
+            "max": "feat/stats-rankings-contract: approved ranking plan; implementation pending",
+            "tg": "feat/stats-rankings-contract: approved ranking plan; implementation pending"
+          }
+        }
       }
     },
     "stats tasks": {
@@ -2998,154 +3348,40 @@
       "in": "all",
       "options": {
         "--background": "all",
-        "--catch-up": {
-          "in": [],
-          "planned": {
-            "max": "search catch-up SDK adoption",
-            "tg": "search catch-up SDK adoption"
-          }
-        },
-        "--catch-up-chunks": {
-          "in": [],
-          "planned": {
-            "max": "search catch-up SDK adoption",
-            "tg": "search catch-up SDK adoption"
-          }
-        },
-        "--catch-up-messages": {
-          "in": [],
-          "planned": {
-            "max": "search catch-up SDK adoption",
-            "tg": "search catch-up SDK adoption"
-          }
-        },
-        "--catch-up-time": {
-          "in": [],
-          "planned": {
-            "max": "search catch-up SDK adoption",
-            "tg": "search catch-up SDK adoption"
-          }
-        },
+        "--catch-up": "all",
+        "--catch-up-chunks": "all",
+        "--catch-up-messages": "all",
+        "--catch-up-time": "all",
         "--estimate": "all",
         "--last": "all",
         "--limit": "all",
-        "--no-catch-up": {
-          "in": [],
-          "planned": {
-            "max": "search catch-up SDK adoption",
-            "tg": "search catch-up SDK adoption"
-          }
-        },
+        "--no-catch-up": "all",
         "--page-size": "all",
         "--pause": "all",
         "--since-time": "all"
       }
     },
     "store gaps": {
-      "in": [],
-      "planned": {
-        "max": "search follow-ups: SDK adoption",
-        "tg": "search follow-ups: SDK adoption"
-      }
+      "in": "all"
     },
     "store gaps plan": {
-      "in": [],
-      "planned": {
-        "max": "search follow-ups: SDK adoption",
-        "tg": "search follow-ups: SDK adoption"
-      }
+      "in": "all"
     },
     "store gaps repair": {
-      "in": [],
-      "planned": {
-        "max": "search follow-ups: SDK adoption",
-        "tg": "search follow-ups: SDK adoption"
-      },
+      "in": "all",
       "options": {
-        "--background": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--catch-up": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--catch-up-chunks": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--catch-up-messages": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--catch-up-time": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--fingerprint": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--limit": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--max-gaps": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--no-catch-up": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--page-size": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--pause": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        },
-        "--repair-time": {
-          "in": [],
-          "planned": {
-            "max": "search follow-ups: SDK adoption",
-            "tg": "search follow-ups: SDK adoption"
-          }
-        }
+        "--background": "all",
+        "--catch-up": "all",
+        "--catch-up-chunks": "all",
+        "--catch-up-messages": "all",
+        "--catch-up-time": "all",
+        "--fingerprint": "all",
+        "--limit": "all",
+        "--max-gaps": "all",
+        "--no-catch-up": "all",
+        "--page-size": "all",
+        "--pause": "all",
+        "--repair-time": "all"
       }
     },
     "store info": {