From dc45faaf4ee15528040306ff7d4a53c8b96365f1 Mon Sep 17 00:00:00 2001
From: "@zimeg" <zim@o526.net>
Date: Fri, 3 Apr 2026 01:10:42 -0700
Subject: [PATCH] docs(slack): order recommended scopes and events

---
 docs/channels/slack.md         | 32 ++++++++++++++++----------------
 extensions/slack/src/shared.ts | 30 +++++++++++++++---------------
 2 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/docs/channels/slack.md b/docs/channels/slack.md
index c00654e9d88..927e79640c7 100644
--- a/docs/channels/slack.md
+++ b/docs/channels/slack.md
@@ -420,9 +420,15 @@ Notes:
   "oauth_config": {
     "scopes": {
       "bot": [
-        "chat:write",
+        "app_mentions:read",
+        "assistant:write",
         "channels:history",
         "channels:read",
+        "chat:write",
+        "commands",
+        "emoji:read",
+        "files:read",
+        "files:write",
         "groups:history",
         "im:history",
         "im:read",
@@ -430,17 +436,11 @@ Notes:
         "mpim:history",
         "mpim:read",
         "mpim:write",
-        "users:read",
-        "app_mentions:read",
-        "assistant:write",
-        "reactions:read",
-        "reactions:write",
         "pins:read",
         "pins:write",
-        "emoji:read",
-        "commands",
-        "files:read",
-        "files:write"
+        "reactions:read",
+        "reactions:write",
+        "users:read"
       ]
     }
   },
@@ -449,17 +449,17 @@ Notes:
     "event_subscriptions": {
       "bot_events": [
         "app_mention",
+        "channel_rename",
+        "member_joined_channel",
+        "member_left_channel",
         "message.channels",
         "message.groups",
         "message.im",
         "message.mpim",
-        "reaction_added",
-        "reaction_removed",
-        "member_joined_channel",
-        "member_left_channel",
-        "channel_rename",
         "pin_added",
-        "pin_removed"
+        "pin_removed",
+        "reaction_added",
+        "reaction_removed"
       ]
     }
   }
diff --git a/extensions/slack/src/shared.ts b/extensions/slack/src/shared.ts
index e4927bae5b2..080c0306e8e 100644
--- a/extensions/slack/src/shared.ts
+++ b/extensions/slack/src/shared.ts
@@ -50,9 +50,15 @@ function buildSlackManifest(botName: string) {
     oauth_config: {
       scopes: {
         bot: [
-          "chat:write",
+          "app_mentions:read",
+          "assistant:write",
           "channels:history",
           "channels:read",
+          "chat:write",
+          "commands",
+          "emoji:read",
+          "files:read",
+          "files:write",
           "groups:history",
           "im:history",
           "im:read",
@@ -60,17 +66,11 @@ function buildSlackManifest(botName: string) {
           "mpim:history",
           "mpim:read",
           "mpim:write",
-          "users:read",
-          "app_mentions:read",
-          "assistant:write",
-          "reactions:read",
-          "reactions:write",
           "pins:read",
           "pins:write",
-          "emoji:read",
-          "commands",
-          "files:read",
-          "files:write",
+          "reactions:read",
+          "reactions:write",
+          "users:read",
         ],
       },
     },
@@ -79,17 +79,17 @@ function buildSlackManifest(botName: string) {
       event_subscriptions: {
         bot_events: [
           "app_mention",
+          "channel_rename",
+          "member_joined_channel",
+          "member_left_channel",
           "message.channels",
           "message.groups",
           "message.im",
           "message.mpim",
-          "reaction_added",
-          "reaction_removed",
-          "member_joined_channel",
-          "member_left_channel",
-          "channel_rename",
           "pin_added",
           "pin_removed",
+          "reaction_added",
+          "reaction_removed",
         ],
       },
     },