feat(cli): chat --follow

chat GROUP --follow prints the last messages, then each one the node pushes,
until Ctrl+C (exit 130). The connection is pinged every half minute; one
that closes, fails or stops answering is opened again, and what was said
meanwhile is read from the history. Each message is printed once, by its
(device, nonce) pair, which the node stores once. With --json, one object
per line. The man page lists it, with an example, and its FILES now names
the device keys kept for the Tier 2 check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 13 insertions, 3 deletions

diff --git a/packages/meshbay-cli/src/meshbay_cli/manpage.py b/packages/meshbay-cli/src/meshbay_cli/manpage.py
index 022cd99..43a0fee 100644
--- a/packages/meshbay-cli/src/meshbay_cli/manpage.py
+++ b/packages/meshbay-cli/src/meshbay_cli/manpage.py
@@ -37,8 +37,8 @@ EXIT_CODES = {
                     "accepted by the node, a folder read-only or unavailable, leaving a "
                     "group you own, revoking this machine, deleting a file you may not "
                     "delete.",
-    errors.INTERRUPTED: "Interrupted (Ctrl+C). A download resumes where it stopped "
-                        "on the next run.",
+    errors.INTERRUPTED: "Interrupted (Ctrl+C), which is also how chat \\-\\-follow "
+                        "ends. A download resumes where it stopped on the next run.",
 }
 
 DESCRIPTION = r"""
@@ -232,6 +232,14 @@ before anything is asked or sent.
 shows the last messages of a group, oldest first, each with its time and the name
 its sender sealed in it, and posts one with
 .BR \-m .
+With
+.BR \-\-follow ,
+it then prints each new message as it arrives, until Ctrl+C (status 130); a
+connection that drops or stops answering is opened again, and what was said
+meanwhile is printed, each message once.
+With
+.BR \-\-json ,
+one object per line.
 Messages are encrypted and signed end to end, as the application's are; one this
 machine cannot verify or open is shown as unreadable, never left out.
 The device that signed a message is checked against the group's roster and the
@@ -263,7 +271,8 @@ On Windows,
 .IR %LOCALAPPDATA%\emeshbay\-cli\e .
 Holds
 .B state.json
-(the hub, the account name, pinned node keys, the browser access setting),
+(the hub, the account name, pinned node keys, the device keys accepted for
+the members whose messages were read, the browser access setting),
 .B secrets.enc
 (the session, the keys, invitation codes waiting for their node; encrypted),
 .B store.key
@@ -321,6 +330,7 @@ meshbay\-cli search \-t audio holiday
 meshbay\-cli search beach 2024 | head \-1 | xargs \-d '\\n' meshbay\-cli get
 meshbay\-cli rm 'Family/documents/draft*.odt'
 meshbay\-cli chat \-100 Family
+meshbay\-cli \-\-json chat Family \-\-follow | jq \-r .text
 echo 'On my way' | meshbay\-cli chat Family \-m \-
 meshbay\-cli devices approve Family@bob ZX4P\-7QRT
 meshbay\-cli leave \-\-yes Club@carol