Merge pull request #626 from rusq/ent-tips

Enterprise tips and changelog update

Author: rusq

README.md

@@ -35,6 +35,8 @@ files and emojis.  Generate Slack Export without admin privileges.
 > 
 > You are responsible for ensuring your use complies with your organisation’s
 > policies and Slack’s terms of service.
+>
+> **See [Enterprise Workspace Tips](doc/enterprise.md).**
 
 ## Description
 

cmd/slackdump/internal/man/assets/changelog.md

@@ -1,5 +1,42 @@
 # What's New?
 
+## v4.1.0
+
+### New Features
+
+- **MCP Server** (`slackdump mcp`): a read-only Model Context Protocol server
+  for querying Slackdump archives with AI agents (Claude, GitHub Copilot,
+  OpenCode, etc.).  Supports both **stdio** and **HTTP** transports.  Available
+  tools: `load_source`, `list_channels`, `get_channel`, `list_users`,
+  `get_messages`, `get_thread`, `get_workspace_info`, and `command_help`.
+
+- **Auto-updater** (`slackdump tools update`): checks for a newer release on
+  GitHub and optionally installs it.  Pass `-auto` to update without prompts.
+  Marked experimental; supports brew, apt, pacman, and direct binary replacement.
+
+- **`-fail-hard` flag**: opt in to hard-failing on non-critical per-channel
+  errors (e.g. `not_in_channel`, `channel_not_found`) across `archive`,
+  `export`, and `dump`.  By default these errors are skipped and logged.
+
+- **`-member-only` in `list channels`**: the `-member-only` flag is now
+  respected by `slackdump list channels` in addition to `archive`.
+
+- **QR code input size override**: the maximum size of the QR code image paste
+  field can be tuned via the `QR_CODE_SIZE` environment variable for workspaces
+  that produce unusually large QR images.
+
+### Bug Fixes
+
+- Enterprise channel filtering: fixed incorrect channel filtering that could
+  silently drop channels in Enterprise Grid workspaces.
+
+- `not_in_channel` no longer aborts a full-workspace archive; the channel is
+  skipped and the run continues (see also `-fail-hard` above).
+
+- `IsMember` logic now falls back to the `C`-prefix heuristic for channels
+  where the membership field is absent, fixing missing channels in
+  `--member-only` runs.
+
 ## v4.0.0
 
 - New channel type filtering via `--chan-types` and wizard multi-select, wired through list/archive/export/resume flows.

doc/README.md

@@ -12,6 +12,7 @@
   - [Dumping messages and threads](usage-channels.md)
   - [Creating a Slack Export](usage-export.md)
   - [Downloading all Emojis](usage-emoji.md)
+- [Enterprise Workspace Tips](enterprise.md)
 - [Compiling from Sources](compiling.md)
 - [Troubleshooting](troubleshooting.md)
 

doc/enterprise.md

@@ -0,0 +1,39 @@
+# Enterprise Workspaces Tips
+
+[Back to User Guide](README.md)
+
+This section applies only in case your Slack Workspace is on Enterprise Plan.
+
+> [!WARNING]
+> # Enterprise Workspaces Security Alerts
+>
+> Depending on your Slack plan and security settings, using Slackdump may
+> trigger Slack security alerts and/or notify workspace administrators of
+> unusual or automated access/scraping attempts.
+> 
+> You are responsible for ensuring your use complies with your organisation’s
+> policies and Slack’s terms of service.
+
+That said, here are some tips for safe operations without triggering the
+scraping alerts:
+
+1. **Always use `-channel-users` flag**.  This will avoid accessing the full
+   user list, which may be long and may trigger the logout.  Example:
+   ```shell
+   slackdump archive -channel-users C01581023
+   ```
+2. **Avoid full channel listing**.  Collect the URLs or Channel IDs of the
+   channels that you need and create a text file with each URL or Channel ID on
+   a separate line (see `slackdump help syntax`).  Once you have collected
+   everything you need, run:
+   ```shell
+   slackdump archive -channel-users @list.txt
+   ```
+   - If you only need to download DMs and the list is short, use
+     `-chan-types im`.  If the DM list is large, prefer tip #1 instead.
+     For example:
+     ```shell
+     slackdump archive -chan-types im
+     ```
+
+[Back to User Guide](README.md)

go.mod

@@ -28,7 +28,7 @@ require (
 	github.com/pressly/goose/v3 v3.27.0
 	github.com/pterm/pterm v0.12.82
 	github.com/refraction-networking/utls v1.8.2
-	github.com/rusq/chttp/v2 v2.0.0
+	github.com/rusq/chttp/v2 v2.0.1
 	github.com/rusq/encio v0.2.0
 	github.com/rusq/fsadapter v1.1.0
 	github.com/rusq/osenv/v2 v2.0.1

go.sum

@@ -228,6 +228,8 @@ github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDN
 github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
 github.com/rusq/chttp/v2 v2.0.0 h1:9cO6VCWHjBZgET7XaezmgFHWBbcWoJuopInu8mmmSxo=
 github.com/rusq/chttp/v2 v2.0.0/go.mod h1:4E429epjP89evgAUlKNy5GLbr6phAUUNZ6yx6uaGDWE=
+github.com/rusq/chttp/v2 v2.0.1 h1:8YMNpBnKIMv2/PhXaMrSR/9KFcj3tkEfAUEljCzPSJo=
+github.com/rusq/chttp/v2 v2.0.1/go.mod h1:LQ4GhcfnbK2XqwXa2/RxUtuqnapQk1C2LNUkh8ysz8U=
 github.com/rusq/encio v0.2.0 h1:+EbYnoLrX/mfwjBp0HqozdfOB2EplNDgbA2vIQvnCuY=
 github.com/rusq/encio v0.2.0/go.mod h1:AP3lDpo/BkcHcOMNduBlZdd0sbwhruq6+NZtYm5Mxb0=
 github.com/rusq/fsadapter v1.1.0 h1:/tuzrPNGr4Tx2f8fPK+WudSRBLDvjjDaqVvto1yrVdk=