slack-term 1.39.2 → 1.41.0

package/README.md

@@ -91,7 +91,7 @@ slack search "deploy" --count 50
 slack send "#general" "Hello team"
 # Prints who you're acting as (From: @handle (Uxxxx) — Workspace) + a destination
 # preview + confirm code; rerun with --code=<code> to actually send. Every gated write
-# (send/edit/delete/upload/schedule/channel create/lists/drafts) shows that From: line and
+# (send/edit/delete/upload/schedule/channel create/rename/lists/drafts) shows that From: line and
 # binds it into the code, so a profile switch mid-flow invalidates it instead of acting
 # as the wrong account.
 slack send "#general" "Hello team" --code=<code>
@@ -123,11 +123,15 @@ slack react "<permalink>" eyes --remove   # take a reaction back
 
 # Ask a question with its choices pre-seeded as 1️⃣..🔟 reactions — answering is
 # one tap on an existing pill, no emoji picker. Same two-step confirm gate as send.
+# A ❓ "その他 (other)" pill always follows the choices: pressing it means "none of
+# these" and the answer comes as a reply (exit 5), not as the ❓ itself.
+# The instructions are posted in ja or en: --lang / SLACK_TERM_LANG, else the
+# answerers' Slack locale, else the question's own language, else $LANG, else ja.
 slack ask "@bob" "本番に出してよい?" "出してよい" "待って"
 # --wait blocks until answered and prints ONLY the answer on stdout, so it composes:
 ANS=$(slack ask "@bob" "本番に出してよい?" "出してよい" "待って" --code=<code> --wait)
 # exit 0 = answered, 2 = timed out (--timeout, default 3600s), 3 = transport failure,
-# 4 = a reply matched several choices, 5 = a free-text reply that picked NO choice —
+# 4 = a reply matched several choices, 6 = the question was voided, 5 = a free-text reply that picked NO choice —
 # the reply text is on stdout, it is not a decision, and the question stays open.
 #
 # The question must say WHO may answer — only their reaction/reply is taken as the
@@ -138,8 +142,20 @@ slack ask "#eng" "@here 誰か見れる?" "見る" "あとで"            # anyo
 #
 # With no choices the question asks for a free-text reply and the reply is the answer.
 # In a DM a plain reply counts; in a channel only reactions and thread replies do.
-# Once answered, the question is edited to "✅ …回答済み > <answer>" and the unpressed
-# seeds are removed, leaving the chosen pill visible.
+# Once answered, the question is edited to "✅ …回答済み > <answer>" — the body/background
+# and the CHOSEN option line stay; the other options, ❓ line and instructions go. The
+# unpressed seeds are removed, leaving the chosen pill visible.
+#
+# Thread notes (audience replies that are not the answer, even after ✅) go to
+# stderr; --json puts {answer, notes[], cursor} on stdout. Feed cursor back as --after:
+#   slack ask --waitFor='<permalink>' --timeout 0 --json --after=<cursor>
+#
+# Retire a question that expired / stopped meaning anything (無効化) — waits on it exit 6:
+#   slack ask --void='<permalink>' --reason 'head moved' --superseded-by '<new permalink>'
+# Change one: slack ask --edit='<permalink>' ["new question" [choices…]] [--body …]
+#   (options only while unanswered; after that: --void='<permalink>' --reask …)
+# List mine with live state: slack ask --ls [--stale 24h] [--state all] [--json]
+# (`slack edit` refuses an edit that would break an ask/poll; --force overrides.)
 #
 # WITHOUT --wait, stdout is the command that collects the answer later:
 RESUME=$(slack ask "@bob" "本番に出してよい?" "出してよい" "待って" --code=<code>)

package/SKILL.md

@@ -120,7 +120,7 @@ plus `[as bot]` under `--as-bot`) and the resolved destination (`→ ... — THR
 `→ ... — NEW top-level message`); verify both before re-running with `--code`.
 
 **Every** gated write opens its preview with that same `From:` line — `send`, `edit`,
-`delete`, `upload`, `schedule send`, `schedule rm`, `channel create`, `lists create/add/set/share`, `drafts edit`,
+`delete`, `upload`, `schedule send`, `schedule rm`, `channel create`, `channel rename`, `lists create/add/set/share`, `drafts edit`,
 `drafts delete` — and the identity is part of the confirm hash: switching
 profile/token between preview and confirm invalidates the code instead of acting as
 someone else. It matters most on `schedule send`, where the message goes out later,
@@ -162,11 +162,19 @@ without losing clicks. A reaction is durable state anyone can read back later.
   the other party counts automatically.
 - **Answer paths**: a pill, or free text. In a DM a plain reply counts; in a channel only
   reactions and thread replies do (a channel carries unrelated traffic).
+- **❓ is the standing "other" choice.** Every question with choices lists it last
+  (`1️⃣ … 2️⃣ … 3️⃣ … ❓ その他 — スレッドで返信`) and seeds it after the keycaps. Pressing it
+  is not an answer — `--wait` notes it on stderr and keeps waiting for the reply, which
+  arrives as free text (exit `5`).
+- **The instructions are posted in `ja` or `en`.** `--lang` (or `SLACK_TERM_LANG`) decides;
+  otherwise the answerers' Slack locale when they all share one, else the language the
+  question is written in, else the system locale, else `ja`. The confirm gate prints the
+  choice and why (`Language: en (answerers' Slack locale; …)`). `--waitFor` reads either.
 - **Two pills pressed = no answer.** Changing your mind leaves both reactions in place, so
   `ask` says so in the thread once and keeps waiting rather than guessing.
 - **Exit codes** are the contract: `0` answered (the answer alone on stdout), `2` nobody
   replied, `3` transport/config failure, `4` a reply matched several choices (stdout
-  empty), `5` a **free-text reply** that picked none of the offered choices — the reply
+  empty), `6` the question was **voided** (stop waiting), `5` a **free-text reply** that picked none of the offered choices — the reply
   text is on stdout. Everything human-facing goes to stderr, so
   `ANS=$(slack ask … --wait)` is safe.
 - **A reply that chooses nothing is delivered, but is not a decision.** When choices were
@@ -177,6 +185,46 @@ without losing clicks. A reaction is durable state anyone can read back later.
   so a pill pressed later still decides it: re-wait past the delivered reply with
   `slack ask --waitFor='<permalink>' --after=<reply ts>` (stderr prints this line).
 
+**Thread notes ride along with the answer.** A reply from the audience that is not the
+answer (「あと cswap ls も見て」 next to a pressed pill) is a *note*. Notes are read even when
+a pill answered, and again on every `--waitFor` of a ✅ question, so a note written after
+the answer still reaches you. Plain mode: stdout is still the answer alone, and the notes go
+to stderr. `--json`: stdout is one object
+`{status, answer, how, who, notes:[{ts,user,text,permalink}], cursor, permalink}`, with the same
+exit codes. Pass `cursor` back as `--after` on your next `--waitFor --timeout 0` and you
+never get the same note twice. Only the question's audience counts; the asker, bots and
+bystanders are never notes.
+
+**Answering keeps the context.** The ✅ rewrite keeps the question's body (its background)
+and the chosen option; only the options not chosen, the ❓ line and the instructions go.
+The head is unchanged (`:white_check_mark:` prefix, question, stamp, quoted answer), so
+anything that keys on the prefix or re-reads the answer works on old and new ✅ bodies alike.
+
+**Voiding a question (無効化).** When a question has expired or stopped meaning anything
+(the head it was pinned to moved, the decision was made elsewhere), retire it:
+`slack ask --void='<permalink>' --reason '…' [--superseded-by '<new permalink>']`
+(repeatable `--void=`; alias `slack ask void <link…>`; same `--code` gate; own questions
+only, `--as-bot` for the bot's). The text becomes `:no_entry_sign:` + reason with the body
+kept, our pills come off, and a 🚫 reaction is added. Three states, three prefixes:
+`:question:` open, `:white_check_mark:` answered, `:no_entry_sign:` void. `--wait` /
+`--waitFor` on a void question **exit 6** (`--json` → `status: "void"`): stop waiting.
+Answered questions cannot be voided.
+
+**Changing a question: `--edit`, not `slack edit`.**
+`slack ask --edit='<permalink>' ["new question" [choices…]] [--body …]` rebuilds it with the
+ask layout (same `--code` gate), so collect still reads it. Wording can change any time;
+the **options** only while nobody has answered. After that, re-ask it:
+`slack ask --void='<permalink>' --reask [--reason …] ["new question" [choices…]]` posts the
+question again in the same place (old text/choices/body unless you give new ones) and voids
+the old one as replaced by it — one gate for both. Plain `slack edit` refuses an edit that
+would break an ask/poll (text no longer readable, or an answered/void question made open
+again); edits that keep it readable — e.g. a script writing the ✅ form — pass as usual.
+
+**What did I ask, and what became of it.** `slack ask --ls` lists your asks from the local
+sent-log with their LIVE state (`--state open|answered|void|all`, default open; `--channel`;
+`--json`). `--ls --stale 24h` = open and older than 24h, and prints the one `--void=` command
+that would retire them all (behind the usual gate). Only asks sent from this machine.
+
 **Collecting an answer you did not block on.** Without `--wait`, stdout is a runnable
 `slack ask --waitFor='<permalink>'`. Run it any time — it re-reads the question from Slack
 and recovers everything it needs by parsing the message, so nothing is stored locally and
@@ -275,6 +323,22 @@ Reason flags stack independently of progress and of each other: ❗ `exclamation
 `slack thread`/`slack read` before replying to avoid duplicates; consolidate multiple
 points into one message.
 
+### todos — Slack's To-dos tab (read-only)
+
+Not `slack todo`: that tracks tasks as reactions. `slack todos` reads Slack's own
+**personal** To-dos tab (the successor of "Later"), the list in the sidebar.
+
+```bash
+slack todos                       # open to-dos, soonest due first (OVERDUE marked)
+slack todos --filter completed    # also: saved (everything saved), archived
+slack todos --json -n 20          # one object per item: due, done, permalink, text
+```
+
+There is no public API: it uses the desktop client's internal `saved.list`, so
+it needs the **xoxc session** (`slack auth login`) and shows only your own
+to-dos. Bots can't see them. Slack can change this endpoint without notice.
+Adding and completing to-dos is not supported yet.
+
 ## Output formatting
 
 - DM channels render as `@DisplayName`; public channels as `#channel-name`.