@jtalk22/slack-mcp 3.1.0 → 3.2.0

package/scripts/record-demo.js

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-/**
- * Demo video recording script using Playwright
- * Records the Claude Desktop demo in fullscreen mode with auto-play
- *
- * Usage: npm run record-demo
- * Output: docs/videos/demo-claude-TIMESTAMP.webm
- */
-
-import { chromium } from 'playwright';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { mkdirSync, existsSync, copyFileSync } from 'fs';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const projectRoot = join(__dirname, '..');
-const argv = process.argv.slice(2);
-const hasArg = (flag) => argv.includes(flag);
-const argValue = (flag) => {
-  const idx = argv.indexOf(flag);
-  return idx >= 0 && idx + 1 < argv.length ? argv[idx + 1] : null;
-};
-
-// Configuration
-const CONFIG = {
-  viewport: { width: 1280, height: 800 },
-  speed: '0.5', // Slow speed for video recording
-  scenarioCount: 5,
-  initialHold: 500,
-  // Title and closing card durations (ms)
-  introDuration: 4000,   // Title card (3s visible + fade)
-  outroDuration: 5500,   // Closing card (4s visible + fades)
-  // Approximate duration per scenario at 0.5x speed (in ms)
-  scenarioDurations: {
-    search: 26000,   // +1s for transition fade
-    thread: 26000,
-    list: 21000,
-    send: 19000,
-    multi: 36000
-  }
-};
-
-const canonicalOutput = argValue('--out') || join(projectRoot, 'docs', 'videos', 'demo-claude.webm');
-const archiveOutput = hasArg('--archive');
-
-async function recordDemo() {
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║  Slack MCP Server - Demo Video Recording                   ║');
-  console.log('╚════════════════════════════════════════════════════════════╝');
-  console.log();
-
-  // Ensure videos directory exists
-  const videosDir = join(projectRoot, 'docs', 'videos');
-  if (!existsSync(videosDir)) {
-    mkdirSync(videosDir, { recursive: true });
-    console.log(`📁 Created directory: ${videosDir}`);
-  }
-
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const timestampedOutput = join(videosDir, `demo-claude-${timestamp}.webm`);
-
-  console.log('🚀 Launching browser...');
-  const browser = await chromium.launch({
-    headless: true,
-  });
-
-  const context = await browser.newContext({
-    viewport: CONFIG.viewport,
-    recordVideo: {
-      dir: videosDir,
-      size: CONFIG.viewport
-    },
-    colorScheme: 'dark'
-  });
-
-  const page = await context.newPage();
-
-  // Load the demo
-  const demoPath = join(projectRoot, 'public', 'demo-claude.html');
-  console.log(`📄 Loading: ${demoPath}`);
-  await page.goto(`file://${demoPath}`);
-  await page.waitForTimeout(1000);
-
-  // Keep first frame brief so autoplay reaches full-screen flow quickly.
-  console.log(`⏸️  Holding initial frame (${CONFIG.initialHold}ms)...`);
-  await page.waitForTimeout(CONFIG.initialHold);
-
-  // Set slow speed for video recording
-  console.log(`⏱️  Setting speed to ${CONFIG.speed}x...`);
-  await page.selectOption('#speedSelect', CONFIG.speed);
-  await page.waitForTimeout(300);
-
-  // Start auto-play BEFORE entering fullscreen (button hidden in fullscreen)
-  console.log('▶️  Starting auto-play...');
-  await page.click('#autoPlayBtn');
-  await page.waitForTimeout(500);
-
-  // Now enter fullscreen mode
-  console.log('🖥️  Entering fullscreen mode...');
-  console.log();
-  await page.keyboard.press('f');
-  await page.waitForTimeout(500);
-
-  // Wait for title card
-  console.log('📺 Showing title card...');
-  await page.waitForTimeout(CONFIG.introDuration);
-
-  // Wait for each scenario
-  const scenarios = ['search', 'thread', 'list', 'send', 'multi'];
-  let totalWait = 0;
-
-  for (let i = 0; i < scenarios.length; i++) {
-    const scenario = scenarios[i];
-    const duration = CONFIG.scenarioDurations[scenario];
-    totalWait += duration;
-
-    console.log(`  📍 Scenario ${i + 1}/${scenarios.length}: ${scenario} (${Math.round(duration/1000)}s)`);
-    await page.waitForTimeout(duration);
-  }
-
-  // Wait for closing card
-  console.log();
-  console.log('🎬 Showing closing screen...');
-  await page.waitForTimeout(CONFIG.outroDuration);
-
-  // Exit fullscreen
-  console.log('🔚 Exiting fullscreen...');
-  await page.keyboard.press('Escape');
-  await page.waitForTimeout(500);
-
-  // Close context to flush video
-  console.log('💾 Saving video...');
-  const video = await page.video();
-  await context.close();
-  await browser.close();
-
-  // Get the actual video path
-  const videoPath = await video.path();
-
-  console.log();
-  console.log('╔════════════════════════════════════════════════════════════╗');
-  console.log('║  ✅ Recording Complete!                                     ║');
-  console.log('╚════════════════════════════════════════════════════════════╝');
-  console.log();
-  copyFileSync(videoPath, canonicalOutput);
-  console.log(`📹 Canonical video: ${canonicalOutput}`);
-  if (archiveOutput) {
-    copyFileSync(videoPath, timestampedOutput);
-    console.log(`🗂️  Archived copy: ${timestampedOutput}`);
-  }
-  console.log();
-  console.log('Next steps:');
-  console.log('  1. Review the canonical video in a media player');
-  console.log('  2. Convert to GIF with FFmpeg:');
-  console.log(`     ffmpeg -i "${canonicalOutput}" -vf "fps=15,scale=800:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" docs/images/demo-claude.gif`);
-  console.log('  3. Re-run with --archive to keep timestamped historical outputs');
-}
-
-recordDemo().catch(err => {
-  console.error('❌ Recording failed:', err.message);
-  process.exit(1);
-});

package/scripts/release-preflight.js

@@ -1,247 +0,0 @@
-#!/usr/bin/env node
-
-import { spawnSync } from "child_process";
-import { mkdirSync, writeFileSync } from "fs";
-import { dirname, resolve } from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = resolve(__dirname, "..");
-const REPORT_PATH = process.env.PREPUBLISH_REPORT_PATH
-  ? resolve(ROOT, process.env.PREPUBLISH_REPORT_PATH)
-  : resolve(ROOT, "output", "release-health", "prepublish-dry-run.md");
-
-const EXPECTED_NAME = process.env.EXPECTED_GIT_NAME || "jtalk22";
-const EXPECTED_EMAIL = process.env.EXPECTED_GIT_EMAIL || "james@revasser.nyc";
-const OWNER_RANGE = process.env.OWNER_CHECK_RANGE || "origin/main..HEAD";
-
-function run(command, args = [], options = {}) {
-  return spawnSync(command, args, {
-    cwd: ROOT,
-    encoding: "utf8",
-    env: process.env,
-    maxBuffer: 20 * 1024 * 1024,
-    ...options
-  });
-}
-
-function trimOutput(text = "", maxChars = 1200) {
-  const normalized = String(text || "").trim();
-  if (!normalized) return "";
-  if (normalized.length <= maxChars) return normalized;
-  return `${normalized.slice(0, maxChars)}... [truncated]`;
-}
-
-function stepResult(name, command, ok, details = "", commandOutput = "") {
-  return { name, command, ok, details, commandOutput };
-}
-
-function gitIdentityStep() {
-  const nameResult = run("git", ["config", "--get", "user.name"]);
-  const emailResult = run("git", ["config", "--get", "user.email"]);
-
-  const actualName = nameResult.stdout.trim();
-  const actualEmail = emailResult.stdout.trim();
-  const ok =
-    nameResult.status === 0 &&
-    emailResult.status === 0 &&
-    actualName === EXPECTED_NAME &&
-    actualEmail === EXPECTED_EMAIL;
-
-  const details = ok
-    ? `Configured as ${actualName} <${actualEmail}>`
-    : `Expected ${EXPECTED_NAME} <${EXPECTED_EMAIL}>, found ${actualName || "(missing)"} <${actualEmail || "(missing)"}>`;
-
-  return stepResult(
-    "Git identity",
-    "git config --get user.name && git config --get user.email",
-    ok,
-    details,
-    `${nameResult.stdout}${nameResult.stderr}${emailResult.stdout}${emailResult.stderr}`
-  );
-}
-
-function ownerAttributionStep() {
-  const result = run("bash", ["scripts/check-owner-attribution.sh", OWNER_RANGE]);
-  return stepResult(
-    "Owner attribution",
-    `bash scripts/check-owner-attribution.sh ${OWNER_RANGE}`,
-    result.status === 0,
-    result.status === 0 ? "All commits in range are owner-attributed." : "Owner attribution check failed.",
-    `${result.stdout}${result.stderr}`
-  );
-}
-
-function publicLanguageStep() {
-  const result = run("bash", ["scripts/check-public-language.sh"]);
-  return stepResult(
-    "Public language",
-    "bash scripts/check-public-language.sh",
-    result.status === 0,
-    result.status === 0 ? "Public wording guardrail passed." : "Disallowed wording found.",
-    `${result.stdout}${result.stderr}`
-  );
-}
-
-function markerScanStep() {
-  const pattern = "Co-authored-by|co-authored-by|Generated with|generated with";
-  const scanPaths = [
-    "README.md",
-    "docs",
-    "public",
-    ".github/RELEASE_NOTES_TEMPLATE.md",
-    ".github/ISSUE_REPLY_TEMPLATE.md"
-  ];
-  const result = run("rg", [
-    "-n",
-    pattern,
-    "--glob",
-    "!docs/release-health/**",
-    "--glob",
-    "!output/release-health/**",
-    ...scanPaths
-  ]);
-
-  if (result.status === 1) {
-    return stepResult(
-      "Public attribution markers",
-      "marker-scan",
-      true,
-      "No non-owner attribution markers found in public surfaces."
-    );
-  }
-
-  return stepResult(
-    "Public attribution markers",
-    "marker-scan",
-    false,
-    result.status === 0
-      ? "Found disallowed markers on public surfaces."
-      : "Marker scan failed.",
-    `${result.stdout}${result.stderr}`
-  );
-}
-
-function runNodeStep(name, scriptPath, extraArgs = []) {
-  const result = run("node", [scriptPath, ...extraArgs]);
-  return stepResult(
-    name,
-    `node ${scriptPath}${extraArgs.length ? ` ${extraArgs.join(" ")}` : ""}`,
-    result.status === 0,
-    result.status === 0 ? "Passed." : "Failed.",
-    `${result.stdout}${result.stderr}`
-  );
-}
-
-function npmPackSnapshot() {
-  const result = run("npm", ["pack", "--dry-run", "--json"]);
-  if (result.status !== 0) {
-    return {
-      ok: false,
-      details: "Unable to generate npm pack snapshot.",
-      output: `${result.stdout}${result.stderr}`
-    };
-  }
-
-  try {
-    const parsed = JSON.parse(result.stdout);
-    const entry = Array.isArray(parsed) ? parsed[0] : parsed;
-    const fileCount = Array.isArray(entry.files) ? entry.files.length : 0;
-    const details = `package size ${entry.size} bytes, unpacked ${entry.unpackedSize} bytes, files ${fileCount}`;
-    return { ok: true, details, output: result.stdout };
-  } catch (error) {
-    return {
-      ok: false,
-      details: "npm pack output was not valid JSON.",
-      output: `${result.stdout}\n${String(error)}`
-    };
-  }
-}
-
-function buildReport(results, packSnapshot) {
-  const generated = new Date().toISOString();
-  const failed = results.filter((step) => !step.ok);
-  const lines = [];
-  lines.push("# Prepublish Dry Run");
-  lines.push("");
-  lines.push(`- Generated: ${generated}`);
-  lines.push(`- Expected owner: \`${EXPECTED_NAME} <${EXPECTED_EMAIL}>\``);
-  lines.push(`- Owner range: \`${OWNER_RANGE}\``);
-  lines.push("");
-  lines.push("## Step Matrix");
-  lines.push("");
-  lines.push("| Step | Status | Command | Details |");
-  lines.push("|---|---|---|---|");
-  for (const step of results) {
-    lines.push(`| ${step.name} | ${step.ok ? "pass" : "fail"} | \`${step.command}\` | ${step.details} |`);
-  }
-  lines.push("");
-  lines.push("## npm Pack Snapshot");
-  lines.push("");
-  lines.push(`- Status: ${packSnapshot.ok ? "pass" : "fail"}`);
-  lines.push(`- Details: ${packSnapshot.details}`);
-  lines.push("");
-
-  if (failed.length === 0 && packSnapshot.ok) {
-    lines.push("## Result");
-    lines.push("");
-    lines.push("Prepublish dry run passed.");
-  } else {
-    lines.push("## Result");
-    lines.push("");
-    lines.push("Prepublish dry run failed.");
-    lines.push("");
-    lines.push("### Failing checks");
-    for (const step of failed) {
-      lines.push(`- ${step.name}`);
-    }
-    if (!packSnapshot.ok) lines.push("- npm pack snapshot");
-  }
-
-  lines.push("");
-  lines.push("## Command Output (Truncated)");
-  lines.push("");
-  for (const step of results) {
-    lines.push(`### ${step.name}`);
-    lines.push("");
-    lines.push("```text");
-    lines.push(trimOutput(step.commandOutput) || "(no output)");
-    lines.push("```");
-    lines.push("");
-  }
-  lines.push("### npm Pack Snapshot");
-  lines.push("");
-  lines.push("```text");
-  lines.push(trimOutput(packSnapshot.output, 4000) || "(no output)");
-  lines.push("```");
-  lines.push("");
-
-  return lines.join("\n");
-}
-
-function main() {
-  const steps = [
-    gitIdentityStep(),
-    ownerAttributionStep(),
-    publicLanguageStep(),
-    markerScanStep(),
-    runNodeStep("Core verification", "scripts/verify-core.js"),
-    runNodeStep("Web verification", "scripts/verify-web.js"),
-    runNodeStep("Install-flow verification", "scripts/verify-install-flow.js"),
-    runNodeStep("Version parity", "scripts/check-version-parity.js", ["--allow-propagation"])
-  ];
-
-  const packSnapshot = npmPackSnapshot();
-  const report = buildReport(steps, packSnapshot);
-
-  mkdirSync(dirname(REPORT_PATH), { recursive: true });
-  writeFileSync(REPORT_PATH, `${report}\n`);
-
-  console.log(`Wrote ${REPORT_PATH}`);
-  const failed = steps.some((step) => !step.ok) || !packSnapshot.ok;
-  if (failed) {
-    process.exitCode = 1;
-  }
-}
-
-main();

package/scripts/setup-git-hooks.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-repo_root="$(git rev-parse --show-toplevel)"
-cd "$repo_root"
-
-[[ -d .githooks ]] || {
-  echo "Missing .githooks directory." >&2
-  exit 1
-}
-
-git config core.hooksPath .githooks
-find .githooks -maxdepth 1 -type f -exec chmod +x {} +
-
-echo "Configured git hooks path: .githooks"

package/scripts/update-github-social-preview.js

@@ -1,208 +0,0 @@
-#!/usr/bin/env node
-
-import { chromium } from "playwright";
-import { existsSync, mkdirSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-
-const argv = process.argv.slice(2);
-const hasFlag = (flag) => argv.includes(flag);
-const argValue = (flag) => {
-  const idx = argv.indexOf(flag);
-  return idx >= 0 && idx + 1 < argv.length ? argv[idx + 1] : null;
-};
-
-const repo = argValue("--repo") || "jtalk22/slack-mcp-server";
-const imagePath = resolve(
-  argValue("--image") || "docs/images/social-preview-v3.png"
-);
-const profileDir = resolve(
-  argValue("--profile-dir") || ".cache/playwright/github-social-preview"
-);
-const evidencePath = resolve(
-  argValue("--evidence") || "output/release-health/social-preview-settings.png"
-);
-const headed = hasFlag("--headed");
-const loginTimeoutMs = Number(argValue("--login-timeout-ms") || 10 * 60 * 1000);
-const settingsUrl = `https://github.com/${repo}/settings`;
-
-if (!existsSync(imagePath)) {
-  console.error(`Missing image: ${imagePath}`);
-  process.exit(1);
-}
-
-console.log(`Repo: ${repo}`);
-console.log(`Image: ${imagePath}`);
-console.log(`Profile: ${profileDir}`);
-console.log(`Opening: ${settingsUrl}`);
-
-mkdirSync(profileDir, { recursive: true });
-mkdirSync(dirname(evidencePath), { recursive: true });
-
-const context = await chromium.launchPersistentContext(profileDir, {
-  channel: "chrome",
-  headless: !headed,
-  viewport: { width: 1440, height: 1100 },
-});
-const page = await context.newPage();
-
-const getSocialPreviewImageSrc = async () => {
-  return page.evaluate(() => {
-    const extractRepoImageUrl = (value) => {
-      if (!value || value === "none") return null;
-      const match = value.match(/https:\/\/repository-images\.githubusercontent\.com\/[^")]+/);
-      return match ? match[0] : null;
-    };
-
-    const headings = Array.from(document.querySelectorAll("h1, h2, h3, h4, strong"));
-    const socialHeading = headings.find((el) => el.textContent?.trim() === "Social preview");
-    if (!socialHeading) return null;
-
-    let node = socialHeading.parentElement;
-    for (let depth = 0; depth < 6 && node; depth += 1) {
-      const img = node.querySelector("img");
-      if (img?.src) return img.src;
-
-      const ownBg = extractRepoImageUrl(getComputedStyle(node).backgroundImage);
-      if (ownBg) return ownBg;
-
-      const descendants = Array.from(node.querySelectorAll("*"));
-      for (const child of descendants) {
-        const bg = extractRepoImageUrl(getComputedStyle(child).backgroundImage);
-        if (bg) return bg;
-      }
-
-      node = node.parentElement;
-    }
-
-    const fallback = Array.from(document.querySelectorAll("img")).find((img) =>
-      img.src.includes("repository-images.githubusercontent.com")
-    );
-    if (fallback?.src) return fallback.src;
-
-    const bgFallback = Array.from(document.querySelectorAll("*"))
-      .map((el) => extractRepoImageUrl(getComputedStyle(el).backgroundImage))
-      .find(Boolean);
-    return bgFallback || null;
-  });
-};
-
-const waitForAuthenticatedSettings = async () => {
-  const started = Date.now();
-  while (Date.now() - started < loginTimeoutMs) {
-    const url = page.url();
-    const title = await page.title().catch(() => "");
-    const onSettings = url.includes(`/${repo}/settings`) && !title.includes("Page not found");
-    if (onSettings) return;
-    await page.waitForTimeout(1200);
-  }
-  throw new Error(
-    `Timed out waiting for authenticated settings page after ${loginTimeoutMs}ms`
-  );
-};
-
-try {
-  await page.goto(settingsUrl, { waitUntil: "domcontentloaded", timeout: 120000 });
-
-  const initialTitle = await page.title().catch(() => "");
-  if (initialTitle.includes("Page not found") || page.url().includes("/login")) {
-    console.log("GitHub settings not authenticated in this browser context.");
-    console.log("Please sign in in the opened browser window, then keep this process running.");
-    await waitForAuthenticatedSettings();
-  }
-
-  // GitHub settings pages often keep long-lived background requests, so
-  // networkidle can hang even when UI is interactive.
-  await page.waitForLoadState("domcontentloaded", { timeout: 120000 });
-
-  const socialHeading = page.getByText("Social preview", { exact: true }).first();
-  await socialHeading.waitFor({ timeout: 120000 });
-  await socialHeading.scrollIntoViewIfNeeded();
-  const beforeImageSrc = await getSocialPreviewImageSrc();
-
-  // In current GitHub settings, upload is often behind an Edit button.
-  const editButtons = page.getByRole("button", { name: /^Edit$/i });
-  const editCount = await editButtons.count();
-  if (editCount > 0) {
-    for (let i = 0; i < editCount; i += 1) {
-      const btn = editButtons.nth(i);
-      if (await btn.isVisible()) {
-        try {
-          await btn.click({ timeout: 3000 });
-          break;
-        } catch {
-          // Try next visible Edit button.
-        }
-      }
-    }
-  }
-
-  const fileInput = page.locator('#repo-image-file-input, input[type="file"]').first();
-  await fileInput.waitFor({ state: "attached", timeout: 90000 });
-  await fileInput.setInputFiles(imagePath);
-  await page.waitForTimeout(1500);
-  const afterUploadImageSrc = await getSocialPreviewImageSrc();
-  const previewUpdated =
-    Boolean(afterUploadImageSrc) && afterUploadImageSrc !== beforeImageSrc;
-  const previewAlreadyPresent =
-    Boolean(beforeImageSrc) &&
-    Boolean(afterUploadImageSrc) &&
-    beforeImageSrc === afterUploadImageSrc;
-
-  // GitHub UI labels can vary; try likely save/update actions.
-  const saveCandidates = [
-    /update social preview/i,
-    /update social image/i,
-    /save changes/i,
-    /^save$/i,
-    /upload/i,
-    /^apply$/i,
-    /^done$/i,
-  ];
-
-  let clicked = false;
-  for (const rx of saveCandidates) {
-    const button = page.getByRole("button", { name: rx }).first();
-    const count = await button.count();
-    if (count > 0) {
-      try {
-        await button.scrollIntoViewIfNeeded();
-        await button.click({ timeout: 5000 });
-        clicked = true;
-        break;
-      } catch {
-        // Keep trying other candidates.
-      }
-    }
-  }
-
-  if (!clicked && !previewUpdated) {
-    const visibleButtons = await page
-      .locator("button:visible")
-      .evaluateAll((els) => els.map((el) => el.textContent?.trim() || "").filter(Boolean))
-      .catch(() => []);
-    console.log("Visible buttons during upload:", visibleButtons.join(" | "));
-  }
-
-  if (previewUpdated) {
-    console.log("Social preview image updated in settings preview.");
-  } else if (previewAlreadyPresent) {
-    console.log("Social preview image is already present; no save action required.");
-  } else if (!clicked) {
-    console.log(
-      "Uploaded image file to input; could not confidently click a save button automatically."
-    );
-    console.log("Complete the final click in the open browser if needed.");
-  } else {
-    await page.waitForTimeout(2500);
-    console.log("Social preview update action submitted.");
-  }
-
-  await page.screenshot({ path: evidencePath, fullPage: true });
-  console.log(`Saved evidence screenshot: ${evidencePath}`);
-  console.log("Done.");
-} catch (error) {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exitCode = 1;
-} finally {
-  await context.close();
-}