@jtalk22/slack-mcp 1.2.3 → 2.0.0

package/lib/token-store.js

@@ -21,6 +21,7 @@ const IS_MACOS = platform() === 'darwin';
 
 // Refresh lock to prevent concurrent extraction attempts
 let refreshInProgress = null;
+let lastExtractionError = null;
 
 // ============ Keychain Storage (macOS only) ============
 
@@ -62,7 +63,7 @@ export function getFromFile() {
     return {
       token: data.SLACK_TOKEN,
       cookie: data.SLACK_COOKIE,
-      updatedAt: data.updated_at
+      updatedAt: data.updated_at || data.UPDATED_AT || null
     };
   } catch (e) {
     return null;
@@ -110,13 +111,53 @@ const SLACK_TOKEN_PATHS = [
   `window.boot_data?.api_token`,
 ];
 
+function normalizeExtractionError(error) {
+  const raw = String(error?.message || error || "");
+
+  if (raw.includes("Executing JavaScript through AppleScript is turned off")) {
+    return {
+      code: "apple_events_javascript_disabled",
+      message: "Chrome blocked JavaScript execution from Apple Events.",
+      detail: "Enable it in Chrome: View > Developer > Allow JavaScript from Apple Events."
+    };
+  }
+
+  if (raw.includes("Application isn't running") || raw.includes("Google Chrome got an error")) {
+    return {
+      code: "chrome_not_ready",
+      message: "Chrome is not ready for token extraction.",
+      detail: "Open Google Chrome with an active Slack tab at app.slack.com."
+    };
+  }
+
+  if (raw.toLowerCase().includes("timed out")) {
+    return {
+      code: "chrome_extraction_timeout",
+      message: "Chrome token extraction timed out.",
+      detail: "Ensure Slack is open in Chrome and retry."
+    };
+  }
+
+  return {
+    code: "chrome_extraction_failed",
+    message: "Chrome token extraction failed.",
+    detail: raw || "Unknown extraction error."
+  };
+}
+
 /**
  * Extract tokens from Chrome (macOS only, uses AppleScript)
  * Returns null on non-macOS platforms
  */
 function extractFromChromeInternal() {
+  lastExtractionError = null;
   if (!IS_MACOS) {
     // AppleScript/osascript is macOS-only
+    lastExtractionError = {
+      code: "unsupported_platform",
+      message: "Chrome auto-extraction is only available on macOS.",
+      detail: "Use manual token setup on this platform."
+    };
     return null;
   }
 
@@ -138,7 +179,14 @@ function extractFromChromeInternal() {
       encoding: 'utf-8', timeout: 5000
     }).trim();
 
-    if (!cookie || !cookie.startsWith('xoxd-')) return null;
+    if (!cookie || !cookie.startsWith('xoxd-')) {
+      lastExtractionError = {
+        code: "cookie_not_found",
+        message: "Could not extract Slack cookie from Chrome.",
+        detail: "Ensure a logged-in Slack tab is open at app.slack.com."
+      };
+      return null;
+    }
 
     // Try multiple token extraction paths
     const tokenPathsJS = SLACK_TOKEN_PATHS.map((path, i) =>
@@ -161,10 +209,18 @@ function extractFromChromeInternal() {
       encoding: 'utf-8', timeout: 5000
     }).trim();
 
-    if (!token || !token.startsWith('xoxc-')) return null;
+    if (!token || !token.startsWith('xoxc-')) {
+      lastExtractionError = {
+        code: "token_not_found",
+        message: "Could not extract Slack token from Chrome.",
+        detail: "Refresh Slack in Chrome and retry extraction."
+      };
+      return null;
+    }
 
     return { token, cookie };
   } catch (e) {
+    lastExtractionError = normalizeExtractionError(e);
     return null;
   }
 }
@@ -188,6 +244,10 @@ export function extractFromChrome() {
   }
 }
 
+export function getLastExtractionError() {
+  return lastExtractionError;
+}
+
 /**
  * Check if auto-refresh is available on this platform
  */
@@ -197,9 +257,8 @@ export function isAutoRefreshAvailable() {
 
 // ============ Main Token Loader ============
 
-export function loadTokens(forceRefresh = false, logger = console) {
-  // Priority 1: Environment variables
-  if (!forceRefresh && process.env.SLACK_TOKEN && process.env.SLACK_COOKIE) {
+function getStoredTokens() {
+  if (process.env.SLACK_TOKEN && process.env.SLACK_COOKIE) {
     return {
       token: process.env.SLACK_TOKEN,
       cookie: process.env.SLACK_COOKIE,
@@ -207,37 +266,46 @@ export function loadTokens(forceRefresh = false, logger = console) {
     };
   }
 
-  // Priority 2: Token file
-  if (!forceRefresh) {
-    const fileTokens = getFromFile();
-    if (fileTokens?.token && fileTokens?.cookie) {
-      return {
-        token: fileTokens.token,
-        cookie: fileTokens.cookie,
-        source: "file",
-        updatedAt: fileTokens.updatedAt
-      };
-    }
+  const fileTokens = getFromFile();
+  if (fileTokens?.token && fileTokens?.cookie) {
+    return {
+      token: fileTokens.token,
+      cookie: fileTokens.cookie,
+      source: "file",
+      updatedAt: fileTokens.updatedAt
+    };
+  }
+
+  const keychainToken = getFromKeychain("token");
+  const keychainCookie = getFromKeychain("cookie");
+  if (keychainToken && keychainCookie) {
+    return {
+      token: keychainToken,
+      cookie: keychainCookie,
+      source: "keychain"
+    };
   }
 
-  // Priority 3: Keychain
+  return null;
+}
+
+export function loadTokensReadOnly() {
+  return getStoredTokens();
+}
+
+export function loadTokens(forceRefresh = false, logger = console, options = {}) {
+  const { autoExtract = true } = options;
   if (!forceRefresh) {
-    const keychainToken = getFromKeychain("token");
-    const keychainCookie = getFromKeychain("cookie");
-    if (keychainToken && keychainCookie) {
-      return {
-        token: keychainToken,
-        cookie: keychainCookie,
-        source: "keychain"
-      };
-    }
+    const storedTokens = getStoredTokens();
+    if (storedTokens) return storedTokens;
   }
 
-  // Priority 4: Chrome auto-extract
-  logger.error("Attempting Chrome auto-extraction...");
+  if (!autoExtract) return null;
+
+  logger.error?.("Attempting Chrome auto-extraction...");
   const chromeTokens = extractFromChrome();
   if (chromeTokens) {
-    logger.error("Successfully extracted tokens from Chrome!");
+    logger.error?.("Successfully extracted tokens from Chrome!");
     saveTokens(chromeTokens.token, chromeTokens.cookie);
     return {
       token: chromeTokens.token,
@@ -246,6 +314,11 @@ export function loadTokens(forceRefresh = false, logger = console) {
     };
   }
 
+  if (lastExtractionError?.code === "apple_events_javascript_disabled") {
+    logger.error?.(lastExtractionError.message);
+    logger.error?.(lastExtractionError.detail);
+  }
+
   return null;
 }
 

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "1.2.3",
+  "version": "2.0.0",
   "description": "Session-based Slack access for Claude - DMs, channels, search, and threads. Local-first with your existing Slack session.",
   "type": "module",
   "main": "src/server.js",
   "bin": {
-    "slack-mcp": "./src/cli.js",
-    "slack-mcp-server": "./src/server.js",
-    "slack-mcp-http": "./src/server-http.js",
-    "slack-mcp-web": "./src/web-server.js",
-    "slack-mcp-setup": "./scripts/setup-wizard.js"
+    "slack-mcp": "src/cli.js",
+    "slack-mcp-server": "src/server.js",
+    "slack-mcp-http": "src/server-http.js",
+    "slack-mcp-web": "src/web-server.js",
+    "slack-mcp-setup": "scripts/setup-wizard.js"
   },
   "scripts": {
     "start": "node src/server.js",
@@ -24,7 +24,10 @@
     "tokens:auto": "node scripts/token-cli.js auto",
     "tokens:clear": "node scripts/token-cli.js clear",
     "screenshot": "node scripts/capture-screenshots.js",
-    "record-demo": "node scripts/record-demo.js"
+    "record-demo": "node scripts/record-demo.js",
+    "metrics:release-health": "node scripts/collect-release-health.js",
+    "metrics:release-health:delta": "node scripts/build-release-health-delta.js",
+    "verify:version-parity": "node scripts/check-version-parity.js"
   },
   "keywords": [
     "mcp",
@@ -33,55 +36,39 @@
     "slack",
     "slack-api",
     "slack-mcp",
-    "slack-bot",
     "slack-integration",
     "claude",
     "claude-desktop",
     "claude-code",
-    "anthropic",
+    "cursor",
+    "llm",
     "ai",
     "ai-assistant",
-    "ai-agent",
-    "llm",
-    "llm-tools",
-    "chatbot",
-    "dm",
-    "direct-messages",
-    "channels",
-    "workspace",
     "automation",
     "workflow-automation",
-    "browser-tokens",
-    "no-oauth",
-    "cli",
     "developer-tools",
-    "devtools",
+    "cli",
     "productivity",
     "messaging",
-    "chat",
-    "model-context-protocol",
-    "chatgpt",
-    "cursor",
-    "open-source",
-    "openai",
-    "gpt",
-    "gemini",
-    "copilot",
-    "ai-tools",
-    "personal-assistant",
     "message-search",
-    "slack-integration",
-    "workspace-automation"
+    "direct-messages",
+    "channels",
+    "workspace",
+    "session-based",
+    "session-mirroring",
+    "slack-dm",
+    "slack-threads",
+    "workspace-search",
+    "mcp-tools",
+    "mcp-stdio",
+    "mcp-http",
+    "open-source"
   ],
-  "funding": {
-    "type": "individual",
-    "url": "https://github.com/sponsors/jtalk22"
-  },
   "author": "jtalk22",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jtalk22/slack-mcp-server.git"
+    "url": "git+https://github.com/jtalk22/slack-mcp-server.git"
   },
   "homepage": "https://jtalk22.github.io/slack-mcp-server/public/demo.html",
   "bugs": {

package/public/demo-claude.html

@@ -1152,16 +1152,16 @@
     <div class="links">
       <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
       <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md" target="_blank" rel="noopener noreferrer">Setup Guide</a>
-      <a href="https://github.com/jtalk22/slack-mcp-server#30-second-proof" target="_blank" rel="noopener noreferrer">30-Second Proof</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server#30-second-compatibility-check" target="_blank" rel="noopener noreferrer">30-Second Check</a>
     </div>
     <div class="note">
-      Free local-first path with optional team rollout guidance in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+      Free local-first path with team rollout references in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
     </div>
   </div>
   <header class="page-header">
     <h1>
       <span>Slack MCP Server</span>
-      <span class="badge">🔧 MCP Demo v1.2.3</span>
+      <span class="badge">🔧 MCP Demo v2.0.0</span>
     </h1>
     <p>See how Claude uses MCP tools to access your Slack workspace</p>
   </header>
@@ -1233,7 +1233,7 @@
       <div class="title-logo">💬</div>
       <h1>Slack MCP Server</h1>
       <p class="title-tagline">Full Slack access for Claude Desktop</p>
-      <p class="title-version">v1.2.3 • @jtalk22</p>
+      <p class="title-version">v2.0.0 • @jtalk22</p>
     </div>
 
     <!-- Scenario Caption Overlay -->

package/public/demo-video.html

@@ -147,10 +147,10 @@
       <div class="links">
         <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
         <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md" target="_blank" rel="noopener noreferrer">Setup Guide</a>
-        <a href="https://github.com/jtalk22/slack-mcp-server#30-second-proof" target="_blank" rel="noopener noreferrer">30-Second Proof</a>
+        <a href="https://github.com/jtalk22/slack-mcp-server#30-second-compatibility-check" target="_blank" rel="noopener noreferrer">30-Second Check</a>
       </div>
       <div class="note">
-        Free local-first path with optional team rollout guidance in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+        Free local-first path with team rollout references in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
       </div>
     </div>
 

package/public/demo.html

@@ -637,10 +637,10 @@
     <div class="cta-links">
       <a href="https://www.npmjs.com/package/@jtalk22/slack-mcp" target="_blank" rel="noopener noreferrer">Install</a>
       <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/SETUP.md" target="_blank" rel="noopener noreferrer">Setup Guide</a>
-      <a href="https://github.com/jtalk22/slack-mcp-server#30-second-proof" target="_blank" rel="noopener noreferrer">30-Second Proof</a>
+      <a href="https://github.com/jtalk22/slack-mcp-server#30-second-compatibility-check" target="_blank" rel="noopener noreferrer">30-Second Check</a>
     </div>
     <div class="cta-note">
-      Free local-first path with optional team rollout guidance in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
+      Free local-first path with team rollout references in <a href="https://github.com/jtalk22/slack-mcp-server/blob/main/docs/DEPLOYMENT-MODES.md" target="_blank" rel="noopener noreferrer">Deployment Modes</a>.
     </div>
   </div>
 

package/scripts/build-release-health-delta.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+
+const METRICS = [
+  "npm downloads (last week)",
+  "npm downloads (last month)",
+  "stars",
+  "forks",
+  "open issues",
+  "14d views",
+  "14d unique visitors",
+  "14d clones",
+  "14d unique cloners",
+  "deployment-intake submissions (all-time)",
+];
+
+const DEFAULT_AFTER = resolve("docs", "release-health", "latest.md");
+const DEFAULT_OUT = resolve("docs", "release-health", "automation-delta.md");
+const TARGETS = {
+  "npm downloads (last week)": { operator: ">=", value: 180 },
+  "deployment-intake submissions (all-time)": { operator: ">=", value: 2 },
+};
+
+function escapeRegex(input) {
+  return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function parseArgs(argv) {
+  const args = { before: null, after: DEFAULT_AFTER, out: DEFAULT_OUT };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--before") {
+      if (!argv[i + 1]) throw new Error("Missing value for --before");
+      args.before = argv[i + 1];
+      i += 1;
+      continue;
+    }
+    if (arg === "--after") {
+      if (!argv[i + 1]) throw new Error("Missing value for --after");
+      args.after = argv[i + 1];
+      i += 1;
+      continue;
+    }
+    if (arg === "--out") {
+      if (!argv[i + 1]) throw new Error("Missing value for --out");
+      args.out = argv[i + 1];
+      i += 1;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+  return args;
+}
+
+function readSnapshot(path) {
+  if (!path || !existsSync(path)) {
+    return { path, metrics: new Map(), generatedAt: null };
+  }
+
+  const content = readFileSync(path, "utf8");
+  const generatedAtMatch = content.match(/^- Generated:\s+(.+)$/m);
+  const metrics = new Map();
+
+  for (const label of METRICS) {
+    const metricRegex = new RegExp(`^- ${escapeRegex(label)}:\\s+(.+)$`, "m");
+    const match = content.match(metricRegex);
+    if (!match) continue;
+
+    const raw = match[1].trim();
+    if (raw.toLowerCase() === "n/a") {
+      metrics.set(label, null);
+      continue;
+    }
+
+    const parsed = Number(raw.replace(/,/g, ""));
+    metrics.set(label, Number.isFinite(parsed) ? parsed : null);
+  }
+
+  return {
+    path,
+    metrics,
+    generatedAt: generatedAtMatch ? generatedAtMatch[1].trim() : null,
+  };
+}
+
+function formatValue(value) {
+  return value === null || value === undefined ? "n/a" : `${value}`;
+}
+
+function formatDelta(beforeValue, afterValue) {
+  if (!Number.isFinite(beforeValue) || !Number.isFinite(afterValue)) {
+    return "n/a";
+  }
+  const delta = afterValue - beforeValue;
+  if (delta > 0) return `+${delta}`;
+  return `${delta}`;
+}
+
+function evaluateTarget(metricLabel, value) {
+  const target = TARGETS[metricLabel];
+  if (!target || !Number.isFinite(value)) {
+    return null;
+  }
+
+  if (target.operator === ">=") {
+    return value >= target.value;
+  }
+  return null;
+}
+
+function displayPath(path) {
+  if (!path) return "(none found)";
+  const relPath = relative(process.cwd(), path);
+  if (relPath && !relPath.startsWith("..")) {
+    return relPath;
+  }
+  return path;
+}
+
+function renderMarkdown(beforeSnapshot, afterSnapshot, rows) {
+  const lines = [];
+  lines.push("# Automated Release Health Delta");
+  lines.push("");
+  lines.push(
+    `- Baseline snapshot: ${
+      beforeSnapshot.path && existsSync(beforeSnapshot.path) ? `\`${displayPath(beforeSnapshot.path)}\`` : "`(none found)`"
+    }`
+  );
+  lines.push(`- Current snapshot: \`${displayPath(afterSnapshot.path)}\``);
+  lines.push("");
+  lines.push("| Metric | Baseline | Current | Delta |");
+  lines.push("|---|---:|---:|---:|");
+
+  for (const row of rows) {
+    lines.push(
+      `| ${row.metric} | ${formatValue(row.beforeValue)} | ${formatValue(row.afterValue)} | ${formatDelta(
+        row.beforeValue,
+        row.afterValue
+      )} |`
+    );
+  }
+
+  lines.push("");
+  lines.push("## Target Checks");
+  lines.push("");
+
+  for (const metric of Object.keys(TARGETS)) {
+    const value = afterSnapshot.metrics.get(metric) ?? null;
+    const passed = evaluateTarget(metric, value);
+    const target = TARGETS[metric];
+    const status = passed === null ? "n/a" : passed ? "pass" : "miss";
+    lines.push(`- ${metric} ${target.operator} ${target.value}: ${status} (current: ${formatValue(value)})`);
+  }
+
+  if (beforeSnapshot.generatedAt || afterSnapshot.generatedAt) {
+    lines.push("");
+    lines.push("## Snapshot Times");
+    lines.push("");
+    if (beforeSnapshot.generatedAt) {
+      lines.push(`- Baseline generated: ${beforeSnapshot.generatedAt}`);
+    }
+    if (afterSnapshot.generatedAt) {
+      lines.push(`- Current generated: ${afterSnapshot.generatedAt}`);
+    }
+  }
+
+  return `${lines.join("\n")}\n`;
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const beforeSnapshot = readSnapshot(args.before ? resolve(args.before) : null);
+  const afterPath = resolve(args.after);
+
+  if (!existsSync(afterPath)) {
+    throw new Error(`Current snapshot not found: ${afterPath}`);
+  }
+
+  const afterSnapshot = readSnapshot(afterPath);
+  const rows = METRICS.map((metric) => ({
+    metric,
+    beforeValue: beforeSnapshot.metrics.get(metric) ?? null,
+    afterValue: afterSnapshot.metrics.get(metric) ?? null,
+  }));
+
+  const outputPath = resolve(args.out);
+  mkdirSync(dirname(outputPath), { recursive: true });
+  const markdown = renderMarkdown(beforeSnapshot, afterSnapshot, rows);
+  writeFileSync(outputPath, markdown);
+
+  console.log(`Wrote ${outputPath}`);
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}

package/scripts/check-public-language.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# Terms that tend to read as hype/manipulative for technical audiences.
+DISALLOWED='(?i)(\bstealth\b|\bgrowth\b|social-proof|social proof|share kit|\bviral\b|growth loop|\bgrindset\b|\bdominate\b|hack growth|edge line|launch-ready)'
+
+SCAN_PATHS=(
+  "$ROOT/README.md"
+  "$ROOT/docs"
+  "$ROOT/public"
+  "$ROOT/.github/ISSUE_REPLY_TEMPLATE.md"
+  "$ROOT/.github/RELEASE_NOTES_TEMPLATE.md"
+  "$ROOT/docs/COMMUNICATION-STYLE.md"
+)
+
+echo "Scanning public-facing text for disallowed wording..."
+
+if rg -Nni "$DISALLOWED" "${SCAN_PATHS[@]}"; then
+  echo "Disallowed public wording found. Use neutral reliability/compatibility language."
+  exit 1
+fi
+
+echo "Public wording check passed."