docs(connector-slack): document the full Slack scope + event set

[harry-harish]

What

The @peekdev/connector-slack README's scope table only listed assistant:write + chat:write — it predated the channel/share/journey surfaces. This documents the complete, code-grounded Slack app setup so a maintainer configuring the app doesn't hit silent no-ops.

Grounded against the adapter's actual API calls + event registrations

• chat:write — chat.postMessage + assistant.threads.setStatus
• assistant:write — assistant registration / status / title / prompts
• app_mentions:read — @peek in a channel (PR feat(connector-slack): @peek in a channel — app_mention + threaded auto-continue #155)
• channels:history / groups:history / im:history — message events for thread auto-continue + DMs
• files:write — share_session bundle upload (files.uploadV2, PR feat(peek): share a session to a Slack channel — consent-gated share_session #156)
• canvases:write — session-journey canvas (conversations.canvases.create, PR feat(peek): rebuild the session journey in Slack (canvas + Block Kit fallback) #159)
• files:read — the journey's files.info permalink resolution; without it the journey silently degrades to the Block Kit fallback (this one wasn't obvious and wasn't documented anywhere)
• commands — the /peek slash command

Also added Event subscriptions + Socket Mode sections and a reinstall note.

Scope

Docs only. @peekdev/connector-slack is private:true (never published) → no changeset. No code change.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated Slack app setup instructions for Socket Mode.
  • Added a detailed overview of required tokens, permissions, and event subscriptions.
  • Documented capabilities including messaging, assistant threads, history access, file uploads, canvases, and mentions.
  • Clarified that permission changes require reinstalling the Slack app.
  • Explained the transition between chat:write and assistant:write permissions.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 19d2db21-d722-49a8-86f8-1678d76020df

📥 Commits

Reviewing files that changed from the base of the PR and between 99d7e1e and 03792a9.

📒 Files selected for processing (1)

• packages/connector-slack/README.md

---

📝 Walkthrough

Walkthrough

The Slack connector README now documents Socket Mode setup, capability-specific bot scopes, required bot events, app reinstall requirements after scope changes, and the interaction between chat:write and assistant:write.

Changes

Slack connector setup

Layer / File(s)	Summary
Slack scopes and event setup packages/connector-slack/README.md	Documents Socket Mode tokens, maps bot scopes to connector capabilities, lists required bot events, explains app reinstall requirements, and clarifies chat:write and assistant:write behavior.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• Cubenest/rrweb-stack#150: Updates the Slack connector README with related scope and event configuration guidance.

Poem

I’m a rabbit with Slack scopes to share,
Events and tokens neatly laid bare.
Reinstall when permissions take flight,
Keep both write scopes for thinking done right.
Hop, hop—the setup is clear tonight!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the documentation update covering Slack scopes and event subscriptions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}