claude-slack-channel-bots 0.1.1 → 0.1.3

package/README.md

@@ -319,8 +319,11 @@ The `update-config` skill can automate hook installation. It copies or symlinks
 **routing.json CWD mismatch**
 If a Claude Code session connects but immediately disconnects, the session's actual CWD does not match any `cwd` in `routing.json`. Confirm the session's working directory matches the entry exactly (after tilde expansion). Duplicate CWDs across multiple routes are rejected at startup.
 
+**Bot not receiving messages in a new channel**
+After inviting the bot to a channel, Slack may not deliver messages until the bot is @mentioned for the first time. This is a Slack Socket Mode behavior — the first @mention activates event delivery for that channel. After that, all messages flow normally regardless of `requireMention` settings.
+
 **Channel not in access.json**
-Messages to channels not listed in `access.json → channels` are silently dropped. Use the `slack-channel-access` skill or edit `access.json` directly to add the channel ID with a `ChannelPolicy` entry.
+Messages to channels not listed in `access.json → channels` and not present in `routing.json → routes` are silently dropped. Use the `claude-slack-channels-config` skill or edit `access.json` directly to add the channel ID with a `ChannelPolicy` entry.
 
 **Permission relay not working**
 Check that the Slack app has interactivity enabled (Interactivity & Shortcuts → toggle on). Verify `curl` and `jq` are on your `PATH`. Confirm the hook scripts are executable (`chmod +x`). If the port was changed in `routing.json`, ensure `SLACK_STATE_DIR` is set correctly so the hooks can read the updated port.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-slack-channel-bots",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Multi-session Slack-to-Claude bridge — run multiple Claude Code bots across Slack channels via Socket Mode",
   "type": "module",
   "bin": {

package/skills/claude-slack-channels-config/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: claude-slack-channels-config
+description: Manage Slack channel bot access control — pairing, allowlist, channel opt-in, ack reactions, chunking
+version: 1.0.0
+author: Gabe Mahoney
+license: MIT
+user-invocable: true
+argument-hint: "pair <code> | policy <mode> | add <user_id> | remove <user_id> | channel <id> [opts] | ack <emoji|off> | chunking <limit> [mode] | status"
+allowed-tools: [Read, Write, Edit, Bash]
+---
+
+# /claude-slack-channels-config
+
+Manage who can reach Claude Code sessions through Slack, and configure
+message handling (ack reactions, chunking).
+
+## Usage
+
+```
+/claude-slack-channels-config pair <code>                          # Approve a pending pairing
+/claude-slack-channels-config policy <pairing|allowlist|disabled>   # Set DM policy
+/claude-slack-channels-config add <slack_user_id>                   # Add user to allowlist
+/claude-slack-channels-config remove <slack_user_id>                # Remove from allowlist
+/claude-slack-channels-config channel <channel_id> [--mention] [--allow <user_id,...>]  # Opt in a channel
+/claude-slack-channels-config channel remove <channel_id>           # Remove channel opt-in
+/claude-slack-channels-config ack <emoji|off>                       # Set or clear ack reaction
+/claude-slack-channels-config chunking <limit> [length|newline]     # Set text chunk limit and mode
+/claude-slack-channels-config status                                # Show current config
+```
+
+## State File
+
+```bash
+STATE_DIR="${SLACK_STATE_DIR:-$HOME/.claude/channels/slack}"
+# access.json lives at $STATE_DIR/access.json
+# routing.json lives at $STATE_DIR/routing.json
+```
+
+Always resolve the state directory using `$SLACK_STATE_DIR` with fallback to
+`~/.claude/channels/slack/`.
+
+## Instructions
+
+Parse `$ARGUMENTS` and execute the matching subcommand:
+
+### `pair <code>`
+1. Load `access.json`
+2. Find the pending entry matching `<code>` (case-insensitive)
+3. If not found: show "No pending pairing with that code."
+4. If found:
+   - Add `entry.senderId` to `allowFrom`
+   - Remove the pending entry
+   - Save `access.json` with permissions 0o600
+   - Show: `Approved! User <senderId> can now DM this session.`
+   - Send a confirmation message to the user in Slack via the reply tool
+
+### `policy <mode>`
+1. Validate mode is one of: `pairing`, `allowlist`, `disabled`
+2. Update `dmPolicy` in `access.json`
+3. Save with 0o600
+4. Show the new policy and what it means:
+   - `pairing`: New DMs get a code to approve (default)
+   - `allowlist`: Only pre-approved users can DM
+   - `disabled`: No DMs accepted
+
+### `add <user_id>`
+1. Add the Slack user ID to `allowFrom` (deduplicate)
+2. Save with 0o600
+3. Show confirmation
+
+### `remove <user_id>`
+1. Remove from `allowFrom`
+2. Also remove from any channel-level `allowFrom` lists
+3. Save with 0o600
+4. Show confirmation
+
+### `channel <channel_id> [--mention] [--allow <ids>]`
+1. Parse options:
+   - `--mention`: require @mention to trigger (default: false)
+   - `--allow <id1,id2>`: restrict to specific users in that channel
+2. Add/update `channels[channel_id]` in `access.json`
+3. Save with 0o600
+4. Show the channel policy
+
+### `channel remove <channel_id>`
+1. Delete `channels[channel_id]`
+2. Save with 0o600
+3. Show confirmation
+
+### `ack <emoji|off>`
+1. If argument is `off`: remove `ackReaction` from `access.json`
+2. Otherwise: set `ackReaction` to the provided emoji name (without colons)
+3. Save with 0o600
+4. Show confirmation: "Ack reaction set to :<emoji>:" or "Ack reaction disabled."
+
+### `chunking <limit> [length|newline]`
+1. Parse `<limit>` as a positive integer — this sets `textChunkLimit`
+2. If a second argument is provided, validate it is `length` or `newline` — this sets `chunkMode`
+3. If no second argument, leave `chunkMode` unchanged
+4. Save with 0o600
+5. Show confirmation with the new values
+
+### `status`
+1. Load `access.json`
+2. Load `routing.json` from the same state directory
+3. Display:
+   - DM policy
+   - Allowlisted user IDs
+   - Opted-in channels with their policies, showing two categories:
+     - **Implicit** — channels present in `routing.json` routes (automatically opted-in)
+     - **Explicit** — channels configured in `access.json` channels (with their `requireMention` and `allowFrom` settings)
+   - Pending pairings (code + sender ID + expiry)
+   - Ack reaction setting (or "not set")
+   - Text chunk limit (or "not set, default: 4000")
+   - Chunk mode (or "not set, default: newline")
+
+## Security
+
+- Always use atomic writes (write to .tmp then rename) for `access.json`
+- Always set 0o600 permissions on `access.json`
+- If `access.json` is corrupt, move it aside and start fresh

package/skills/setup-slack-channel-bots/SKILL.md

@@ -174,7 +174,9 @@ After collecting at least one route, write the updated `routing.json`.
 **Important:** Remind the user to invite the bot to each channel they configured.
 In Slack, type `/invite @Claude Slack Channel Bots` in each channel (or whatever
 the bot's display name is). The bot cannot receive messages from channels it has
-not been invited to.
+not been invited to. After inviting, send an @mention to the bot in each channel
+— Slack may not deliver messages until the first @mention activates event
+delivery for that channel.
 
 **Optional routing fields** — after required routes are set, offer these with
 their defaults. Prompt only if the user wants to customise:

package/src/postinstall.ts

@@ -9,9 +9,9 @@
  * SPDX-License-Identifier: MIT
  */
 
-import { existsSync, mkdirSync, writeFileSync } from 'fs'
+import { existsSync, mkdirSync, writeFileSync, symlinkSync, readlinkSync, unlinkSync } from 'fs'
 import { homedir } from 'os'
-import { dirname, join } from 'path'
+import { dirname, join, resolve } from 'path'
 import { defaultAccess } from './lib.ts'
 import { MCP_SERVER_NAME } from './config.ts'
 
@@ -65,6 +65,36 @@ export function runPostinstall(options: PostinstallOptions = {}): void {
     console.log(`created: ${accessPath}`)
   }
 
+  // Symlink skills into ~/.claude/skills/
+  const skillsTarget = join(homedir(), '.claude', 'skills')
+  mkdirSync(skillsTarget, { recursive: true })
+
+  const skillNames = ['claude-slack-channels-config']
+  const packageSkillsDir = resolve(dirname(import.meta.filename), '..', 'skills')
+  for (const name of skillNames) {
+    const src = join(packageSkillsDir, name)
+    const dest = join(skillsTarget, name)
+    if (existsSync(src)) {
+      try {
+        // Remove stale symlink or directory if it points elsewhere
+        if (existsSync(dest)) {
+          try {
+            const current = readlinkSync(dest)
+            if (resolve(current) === resolve(src)) {
+              console.log(`skipped: ${dest} (already linked)`)
+              continue
+            }
+          } catch { /* not a symlink — remove it */ }
+          unlinkSync(dest)
+        }
+        symlinkSync(src, dest)
+        console.log(`linked: ${dest} -> ${src}`)
+      } catch (err) {
+        console.log(`warning: could not symlink ${name}: ${err}`)
+      }
+    }
+  }
+
   // slack-mcp.json
   if (existsSync(mcpConfigPath)) {
     console.log(`skipped: ${mcpConfigPath}`)