feat(thread): add reversible inbox-state commands

Author: gnapse

README.md

@@ -103,6 +103,11 @@ tw inbox --unread                  # unread threads only
 tw thread view <ref>               # view thread with comments
 tw thread view <ref> --comment 123 # view a specific comment
 tw thread reply <ref>              # reply to a thread
+tw thread done <ref>               # mark a thread done
+tw thread reopen <ref>             # undo thread done / reopen inbox state
+tw thread mark-unread <ref>        # mark a thread unread again
+tw thread mark-read <ref>          # explicitly mark a thread read
+tw thread restore <ref> --unread   # reopen and return it to unread inbox
 tw conversation unread             # list unread conversations
 tw conversation view <ref>         # view conversation messages
 tw msg view <ref>                  # view a conversation message
@@ -115,6 +120,16 @@ tw away clear                      # clear away status
 
 References accept IDs (`123` or `id:123`), Twist URLs, or fuzzy names (for workspaces/users).
 
+Thread inbox state changes support `--dry-run`, `--json`, bulk refs, and `--from-file`:
+
+```bash
+tw thread reopen 12345 67890 --yes
+tw thread mark-unread --from-file ids.txt --dry-run
+tw thread restore 12345 --unread --json
+```
+
+Migration note: `tw thread done` is now reversible via `tw thread reopen`.
+
 Run `tw --help` or `tw <command> --help` for more options.
 
 ## Shell Completions

skills/twist-cli/SKILL.md

@@ -77,6 +77,16 @@ tw thread reply <ref> "content" --close       # Reply and close the thread
 tw thread reply <ref> "content" --reopen      # Reply and reopen a closed thread
 tw thread done <ref>             # Archive thread (mark done)
 tw thread done <ref> --json      # Archive and return status as JSON
+tw thread done <ref> <ref> --yes # Archive multiple threads after confirmation
+tw thread done --from-file ids.txt --dry-run # Preview bulk archive from file
+tw thread reopen <ref>           # Reopen a done thread
+tw thread reopen <ref> --json    # Return before/after inbox state as JSON
+tw thread reopen <ref> <ref> --yes # Reopen multiple threads
+tw thread mark-unread <ref>      # Mark a thread unread again
+tw thread mark-unread --from-file ids.txt --yes # Bulk mark unread from file
+tw thread mark-read <ref>        # Explicitly mark a thread read
+tw thread restore <ref>          # Restore a thread to the inbox
+tw thread restore <ref> --unread # Restore and mark unread in one step
 tw thread mute <ref>             # Mute thread for 60 minutes (default)
 tw thread mute <ref> --minutes 480  # Mute for custom duration
 tw thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON
@@ -92,6 +102,8 @@ Default `--notify` for reply is EVERYONE_IN_THREAD, which may notify more people
 
 `--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.
 
+Migration note: `tw thread done` is reversible via `tw thread reopen`.
+
 ## Thread Comments
 
 ```bash