@jtalk22/slack-mcp 2.0.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +112 -64
  2. package/docs/CLOUDFLARE-BROWSER-TOOLKIT.md +67 -0
  3. package/docs/DEPLOYMENT-MODES.md +10 -3
  4. package/docs/HN-LAUNCH.md +47 -36
  5. package/docs/INDEX.md +4 -1
  6. package/docs/INSTALL-PROOF.md +5 -5
  7. package/docs/LAUNCH-COPY-v3.0.0.md +73 -0
  8. package/docs/LAUNCH-MATRIX.md +4 -2
  9. package/docs/LAUNCH-OPS.md +24 -23
  10. package/docs/RELEASE-HEALTH.md +9 -0
  11. package/docs/TROUBLESHOOTING.md +27 -0
  12. package/docs/WEB-API.md +13 -4
  13. package/docs/images/demo-channel-messages.png +0 -0
  14. package/docs/images/demo-channels.png +0 -0
  15. package/docs/images/demo-claude-mobile-360x800.png +0 -0
  16. package/docs/images/demo-claude-mobile-390x844.png +0 -0
  17. package/docs/images/demo-main-mobile-360x800.png +0 -0
  18. package/docs/images/demo-main-mobile-390x844.png +0 -0
  19. package/docs/images/demo-main.png +0 -0
  20. package/docs/images/demo-poster.png +0 -0
  21. package/docs/images/demo-sidebar.png +0 -0
  22. package/docs/images/web-api-mobile-360x800.png +0 -0
  23. package/docs/images/web-api-mobile-390x844.png +0 -0
  24. package/package.json +14 -6
  25. package/public/demo-claude.html +83 -10
  26. package/public/demo-video.html +33 -4
  27. package/public/demo.html +136 -2
  28. package/public/index.html +132 -69
  29. package/scripts/capture-screenshots.js +103 -53
  30. package/scripts/check-version-parity.js +25 -11
  31. package/scripts/cloudflare-browser-tool.js +237 -0
  32. package/scripts/collect-release-health.js +1 -1
  33. package/scripts/record-demo.js +22 -9
  34. package/scripts/release-preflight.js +243 -0
  35. package/scripts/setup-wizard.js +1 -1
  36. package/scripts/verify-install-flow.js +2 -1
  37. package/scripts/verify-web.js +49 -1
  38. package/server.json +47 -0
  39. package/smithery.yaml +34 -0
  40. package/src/server-http.js +98 -5
  41. package/src/server.js +18 -6
  42. package/src/web-server.js +5 -3
  43. package/docs/LAUNCH-COPY-v2.0.0.md +0 -59
  44. package/docs/images/demo-claude-v1.2.gif +0 -0
  45. package/docs/images/demo-readme.gif +0 -0
  46. package/docs/release-health/2026-02-25.md +0 -33
  47. package/docs/release-health/2026-02-26.md +0 -33
  48. package/docs/release-health/24h-delta.md +0 -21
  49. package/docs/release-health/24h-end.md +0 -33
  50. package/docs/release-health/24h-start.md +0 -33
  51. package/docs/release-health/latest.md +0 -33
  52. package/docs/release-health/launch-log-template.md +0 -21
  53. package/docs/release-health/version-parity.md +0 -21
  54. package/docs/videos/.gitkeep +0 -0
  55. package/docs/videos/demo-claude-v1.2.webm +0 -0
@@ -1,59 +0,0 @@
1
- # Launch Copy (v2.0.0)
2
-
3
- Use this file for channel-specific copy with consistent technical claims.
4
-
5
- ## Short Release Summary (150 words)
6
-
7
- `@jtalk22/slack-mcp v2.0.0` is out with a focus on deterministic diagnostics and clean operator workflows. This release enforces read-only `--status` behavior in install-path verification, expands `--doctor` coverage to a strict `0/1/2/3` exit matrix, and standardizes structured error envelopes across MCP tool failures and web API validation/runtime paths. Token health handling now reports explicit unknown-age semantics when timestamps are missing, so operators do not get false critical warnings. Metadata is aligned for distribution parity with updated registry-facing server metadata and a new parity checker (`npm run verify:version-parity`) that reports local/npm/registry alignment. MCP tool contracts stay compatible: no renames, no removals. If you use Claude Desktop, Claude Code, or local web mode, this is a drop-in upgrade focused on faster triage and fewer install surprises.
8
-
9
- ## X Thread (7 posts)
10
-
11
- 1. `Slack MCP Server v2.0.0 is live.`
12
- `Focus: deterministic diagnostics + install reliability.`
13
- 2. `No MCP tool renames/removals in this release.`
14
- `Compatibility stays stable.`
15
- 3. `Install-path checks now enforce read-only --status behavior.`
16
- `No token extraction side effects during status checks.`
17
- 4. `--doctor now enforces deterministic exits:`
18
- `0 ready / 1 missing creds / 2 invalid creds / 3 runtime issue.`
19
- 5. `Token health now reports unknown-age semantics when timestamp is missing.`
20
- `No false critical warning from missing metadata.`
21
- 6. `Parity checker added: npm/local/registry view in one report.`
22
- `npm run verify:version-parity`
23
- 7. `Try it:`
24
- `npx -y @jtalk22/slack-mcp --version`
25
- `npx -y @jtalk22/slack-mcp --doctor`
26
- `Repo: https://github.com/jtalk22/slack-mcp-server`
27
-
28
- ## Reddit Post (Technical Variant)
29
-
30
- Title:
31
- - `Slack MCP Server v2.0.0: deterministic install diagnostics, stable tool contracts`
32
-
33
- Body:
34
- ```md
35
- Released `@jtalk22/slack-mcp@2.0.0` today.
36
-
37
- Main changes are reliability-focused:
38
- - install-path verification enforces read-only `--status`
39
- - `--doctor` exit matrix enforced (`0/1/2/3`)
40
- - standardized structured error payloads for MCP tool failures and web API errors
41
- - token health handles missing timestamp as unknown age (no false critical)
42
- - new version parity report script for npm/local/registry checks
43
-
44
- No MCP tool renames or removals in this release.
45
-
46
- Verify:
47
- `npx -y @jtalk22/slack-mcp --version`
48
- `npx -y @jtalk22/slack-mcp --doctor`
49
- `npx -y @jtalk22/slack-mcp --status`
50
-
51
- Repo: https://github.com/jtalk22/slack-mcp-server
52
- npm: https://www.npmjs.com/package/@jtalk22/slack-mcp
53
- ```
54
-
55
- ## Registry Propagation Note
56
-
57
- If registry versions are still syncing right after publish, use this sentence:
58
-
59
- `Release is published; registry metadata is propagating. Timestamp: <UTC timestamp>.`
Binary file
Binary file
@@ -1,33 +0,0 @@
1
- # Release Health Snapshot
2
-
3
- - Generated: 2026-02-25T06:14:12.948Z
4
- - Repo: `jtalk22/slack-mcp-server`
5
- - Package: `@jtalk22/slack-mcp`
6
-
7
- ## Install Signals
8
-
9
- - npm downloads (last week): 139
10
- - npm downloads (last month): 632
11
- - npm latest version: 1.2.3
12
-
13
- ## GitHub Reach
14
-
15
- - stars: 13
16
- - forks: 8
17
- - open issues: 0
18
- - 14d views: 497
19
- - 14d unique visitors: 259
20
- - 14d clones: 118
21
- - 14d unique cloners: 67
22
- - deployment-intake submissions (all-time): 1
23
-
24
- ## 14-Day Reliability Targets (v1.2.3 Cycle)
25
-
26
- - weekly downloads: >= 180
27
- - qualified deployment-intake submissions: >= 2
28
- - maintainer support load: <= 2 hours/week
29
-
30
- ## Notes
31
-
32
- - Update this snapshot daily during the first week, then every 2-3 days.
33
- - Track deployment-intake quality and support load manually in issue notes.
@@ -1,33 +0,0 @@
1
- # Release Health Snapshot
2
-
3
- - Generated: 2026-02-26T12:46:11.970Z
4
- - Repo: `jtalk22/slack-mcp-server`
5
- - Package: `@jtalk22/slack-mcp`
6
-
7
- ## Install Signals
8
-
9
- - npm downloads (last week): 532
10
- - npm downloads (last month): 1011
11
- - npm latest version: 1.2.4
12
-
13
- ## GitHub Reach
14
-
15
- - stars: 13
16
- - forks: 8
17
- - open issues: 0
18
- - 14d views: 498
19
- - 14d unique visitors: 263
20
- - 14d clones: 338
21
- - 14d unique cloners: 113
22
- - deployment-intake submissions (all-time): 1
23
-
24
- ## 14-Day Reliability Targets (v2.0.0 Cycle)
25
-
26
- - weekly downloads: >= 180
27
- - qualified deployment-intake submissions: >= 2
28
- - maintainer support load: <= 2 hours/week
29
-
30
- ## Notes
31
-
32
- - Update this snapshot daily during active release windows, then weekly.
33
- - Track deployment-intake quality and support load manually in issue notes.
@@ -1,21 +0,0 @@
1
- # 24-Hour Release Health Delta
2
-
3
- - Window start snapshot: docs/release-health/24h-start.md
4
- - Window end snapshot: docs/release-health/24h-end.md
5
-
6
- | Metric | Start | End | Delta |
7
- |---|---:|---:|---:|
8
- | npm downloads (last week) | 532 | 532 | 0 |
9
- | npm downloads (last month) | 1011 | 1011 | 0 |
10
- | stars | 13 | 13 | 0 |
11
- | forks | 8 | 8 | 0 |
12
- | open issues | 0 | 0 | 0 |
13
- | 14d views | 498 | 498 | 0 |
14
- | 14d unique visitors | 263 | 263 | 0 |
15
- | 14d clones | 338 | 338 | 0 |
16
- | 14d unique cloners | 113 | 113 | 0 |
17
- | deployment-intake submissions (all-time) | 1 | 1 | 0 |
18
-
19
- ## Qualitative Signal
20
-
21
- - External "first run succeeded" confirmations (issues/discussions): track manually in cycle notes.
@@ -1,33 +0,0 @@
1
- # Release Health Snapshot
2
-
3
- - Generated: 2026-02-26T09:32:53.328Z
4
- - Repo: `jtalk22/slack-mcp-server`
5
- - Package: `@jtalk22/slack-mcp`
6
-
7
- ## Install Signals
8
-
9
- - npm downloads (last week): 532
10
- - npm downloads (last month): 1011
11
- - npm latest version: 1.2.3
12
-
13
- ## GitHub Reach
14
-
15
- - stars: 13
16
- - forks: 8
17
- - open issues: 0
18
- - 14d views: 498
19
- - 14d unique visitors: 263
20
- - 14d clones: 338
21
- - 14d unique cloners: 113
22
- - deployment-intake submissions (all-time): 1
23
-
24
- ## 14-Day Reliability Targets (v1.2.3 Cycle)
25
-
26
- - weekly downloads: >= 180
27
- - qualified deployment-intake submissions: >= 2
28
- - maintainer support load: <= 2 hours/week
29
-
30
- ## Notes
31
-
32
- - Update this snapshot daily during active release windows, then weekly.
33
- - Track deployment-intake quality and support load manually in issue notes.
@@ -1,33 +0,0 @@
1
- # Release Health Snapshot
2
-
3
- - Generated: 2026-02-26T09:32:04.228Z
4
- - Repo: `jtalk22/slack-mcp-server`
5
- - Package: `@jtalk22/slack-mcp`
6
-
7
- ## Install Signals
8
-
9
- - npm downloads (last week): 532
10
- - npm downloads (last month): 1011
11
- - npm latest version: 1.2.3
12
-
13
- ## GitHub Reach
14
-
15
- - stars: 13
16
- - forks: 8
17
- - open issues: 0
18
- - 14d views: 498
19
- - 14d unique visitors: 263
20
- - 14d clones: 338
21
- - 14d unique cloners: 113
22
- - deployment-intake submissions (all-time): 1
23
-
24
- ## 14-Day Reliability Targets (v1.2.3 Cycle)
25
-
26
- - weekly downloads: >= 180
27
- - qualified deployment-intake submissions: >= 2
28
- - maintainer support load: <= 2 hours/week
29
-
30
- ## Notes
31
-
32
- - Update this snapshot daily during active release windows, then weekly.
33
- - Track deployment-intake quality and support load manually in issue notes.
@@ -1,33 +0,0 @@
1
- # Release Health Snapshot
2
-
3
- - Generated: 2026-02-26T12:46:11.970Z
4
- - Repo: `jtalk22/slack-mcp-server`
5
- - Package: `@jtalk22/slack-mcp`
6
-
7
- ## Install Signals
8
-
9
- - npm downloads (last week): 532
10
- - npm downloads (last month): 1011
11
- - npm latest version: 1.2.4
12
-
13
- ## GitHub Reach
14
-
15
- - stars: 13
16
- - forks: 8
17
- - open issues: 0
18
- - 14d views: 498
19
- - 14d unique visitors: 263
20
- - 14d clones: 338
21
- - 14d unique cloners: 113
22
- - deployment-intake submissions (all-time): 1
23
-
24
- ## 14-Day Reliability Targets (v2.0.0 Cycle)
25
-
26
- - weekly downloads: >= 180
27
- - qualified deployment-intake submissions: >= 2
28
- - maintainer support load: <= 2 hours/week
29
-
30
- ## Notes
31
-
32
- - Update this snapshot daily during active release windows, then weekly.
33
- - Track deployment-intake quality and support load manually in issue notes.
@@ -1,21 +0,0 @@
1
- # Launch Log Template
2
-
3
- Use this template to record public distribution actions and outcomes.
4
-
5
- ## Entry Format
6
-
7
- | UTC Timestamp | Channel | Action | URL | Outcome | Notes |
8
- |---|---|---|---|---|---|
9
- | 2026-02-26T00:00:00Z | GitHub | Published release | <url> | success/pending/fail | <note> |
10
-
11
- ## Recommended Channels
12
-
13
- - GitHub release
14
- - npm publish
15
- - MCP registry update
16
- - Smithery update
17
- - awesome-mcp-servers PR
18
- - Glama listing update
19
- - HN post/comment
20
- - X thread
21
- - Reddit post
@@ -1,21 +0,0 @@
1
- # Version Parity Report
2
-
3
- - Generated: 2026-02-26T12:45:39.684Z
4
- - Local target version: 2.0.0
5
-
6
- ## Surface Matrix
7
-
8
- | Surface | Version | Status | Notes |
9
- |---|---|---|---|
10
- | package.json | 2.0.0 | ok | |
11
- | server.json (root) | 2.0.0 | ok | |
12
- | server.json (package entry) | 2.0.0 | ok | |
13
- | npm dist-tag latest | 1.2.4 | mismatch | |
14
- | MCP Registry latest | 1.1.8 | mismatch | |
15
- | Smithery endpoint | n/a | unreachable | check_error: HTTP 401 for https://server.smithery.ai/jtalk22/slack-mcp-server |
16
-
17
- ## Interpretation
18
-
19
- - Local metadata parity: pass.
20
- - External parity mismatch: npm latest, MCP registry latest.
21
- - Propagation mode enabled: external mismatch accepted temporarily.
File without changes
Binary file