slack-term 1.43.0 → 1.45.0

package/README.md

@@ -123,8 +123,14 @@ 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.
+# 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. (Pills posted
+# before ➕ carry ❓ there; they are still read, collected and voided the same way.)
+# --explain (or SLACK_TERM_ASK_EXPLAIN=1) adds an ℹ️ "説明して (explain)" pill after ➕:
+# pressing it asks YOU to explain in the thread and is never an answer — the question
+# stays open. --wait/--waitFor say so on stderr and may post ONE thread note (once per
+# question) saying an explanation is coming; --explain-exit makes that exit 7.
+# --pending only reports a ℹ️ press — it posts nothing.
 # 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" "本番に出してよい?" "出してよい" "待って"
@@ -146,7 +152,7 @@ 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>" — the body/background
-# and the CHOSEN option line stay; the other options, ❓ line and instructions go. The
+# 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
@@ -357,9 +363,15 @@ into a second board.
 
 ### tail — real-time message stream
 
-`slack tail` polls a channel every 3 seconds (configurable via `--interval`) and
-prints new messages as they arrive, in the same `[ts]  @handle:  text` format as
-the `read` command.
+`slack tail` prints new messages in a channel as they arrive, in the same
+`[ts]  @handle:  text` format as the `read` command.
+
+- **Transport: RTM WebSocket** (default) when the token is a desktop session
+  (`xoxc-` + cookie) and none of `--since`, `--timeout`, `--exit-on-message` is
+  given. If RTM can't connect it says `RTM unavailable — switching to polling.`
+- **Fallback: polling** every `--interval` ms (default `60000` = 60 s; e.g.
+  `--interval=3000` for near-real-time at the cost of more API calls). Used for
+  other tokens, with any of the three flags above, or with `--no-rtm`.
 
 ```sh
 slack tail "#general"               # follow new messages from now

package/SKILL.md

@@ -174,10 +174,23 @@ without losing clicks. A reaction is durable state anyone can read back later.
   destination resolve with the bot token (so the bot needs `users:read`).
 - **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 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`).
+  arrives as free text (exit `5`). Questions posted before 2026-10-14 carry ❓ as this
+  pill (line and seed); they keep working, and a ❓ press counts as "other" on either kind.
+  The head marker stays `:question:` — only the pill moved. A free-text question has no
+  other choice and still seeds ❓.
+- **ℹ️ is the "explain first" pill** — offered with `--explain` (or
+  `SLACK_TERM_ASK_EXPLAIN=1`; `--no-explain` overrides), listed under ➕ and seeded after
+  it. ➕ means "none fit, my answer follows"; ℹ️ means "I can't answer yet — explain".
+  It **never answers or closes** the question: no ✅, the pills stay. `--wait`/`--waitFor`
+  print who pressed it on stderr (`--json`: `explain: [user ids]`) and may post ONE thread
+  note per question saying an explanation is coming (the thread is the record — re-presses
+  and re-runs post nothing more). Then explain in the thread and keep collecting.
+  `--explain-exit` stops with exit `7` (stdout empty; `--json` `status: "explain"`) on the
+  run that posts that note, so a `--timeout 0` poller hears about it once. Only the
+  question's audience counts; bots and the asker are ignored.
 - **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
@@ -187,7 +200,7 @@ without losing clicks. A reaction is durable state anyone can read back later.
 - **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), `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
+  text is on stdout. `7` (only with `--explain-exit`) — ℹ️ pressed, explain and collect again. 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
   offered, only a reaction, the choice text, or its number is a decision (`0`). A reply
@@ -208,7 +221,7 @@ never get the same note twice. Only the question's audience counts; the asker, b
 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.
+and the chosen option; only the options not chosen, the ➕ (or ❓) 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.
 
@@ -218,7 +231,11 @@ anything that keys on the prefix or re-reads the answer works on old and new ✅
 (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` /
+`:question:` open, `:white_check_mark:` answered, `:no_entry_sign:` void (the text prefix;
+the open question's marker REACTION is ➕ on a question with choices, ❓ on free text and
+on questions posted before ➕ — search `has::question: OR has::heavy_plus_sign:`; ➕ is a common
+emoji, so that can match unrelated messages — `slack ask --ls` reads the local sent-log
+and is unaffected). `--wait` /
 `--waitFor` on a void question **exit 6** (`--json` → `status: "void"`): stop waiting.
 Answered questions cannot be voided.
 
@@ -254,7 +271,8 @@ an answer can be pressed and nobody ever hears about it.
 collected, and lists the ones somebody answered — grouped by the asking session, with
 the agent pid and whether it is still alive (pid running, started before the ask, same
 CLI), and per item the exact `collect:` line to run (cursor included). It is read-only —
-nothing is posted, edited, stamped or relayed. Collecting is that `slack ask --waitFor=…`
+nothing is posted, edited, stamped or relayed (an ℹ️ explain request is reported on
+stderr, but its thread note is left to `--wait`/`--waitFor`). Collecting is that `slack ask --waitFor=…`
 line: an answer it hands over (exit 0) takes the ask off the list; a free-text reply it
 hands over (exit 5) is not reported again, but a pill pressed after it is.