@must-b/must-b 1.72.7 → 1.72.8

package/scripts/bundle-skills.mjs

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+/**
+ * Skill Singularity Compiler — Phase 42
+ *
+ * Reads all functional skill files from must-b-skills/ (commands, agents,
+ * hooks, SKILL.md) and compiles them into a single embedded JSON bundle at
+ * src/core/embedded-skills.json.
+ *
+ * Explicitly excluded:
+ *   - demo.gif, LICENSE.md, README.md, CHANGELOG.md, SECURITY.md
+ *   - .github/, .vscode/, .devcontainer/, examples/, scripts/, Script/
+ *   - Any binary / non-UTF8 file
+ */
+
+import fs   from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT      = path.resolve(__dirname, '..');
+const SKILLS_BASE = path.join(ROOT, 'must-b-skills');
+const OUT_FILE    = path.join(ROOT, 'src', 'core', 'embedded-skills.json');
+
+// ── Blocklists ──────────────────────────────────────────────────────────────
+
+const SKIP_DIRS = new Set([
+  '.github', '.vscode', '.devcontainer',
+  'examples', 'scripts', 'Script', 'node_modules',
+  'references', 'hooks-handlers',   // docs-only
+]);
+
+const SKIP_FILES = new Set([
+  'README.md', 'CHANGELOG.md', 'SECURITY.md', 'LICENSE.md',
+  'LICENSE', 'LICENSE.txt', 'demo.gif',
+]);
+
+const ALLOWED_EXTENSIONS = new Set(['.md', '.json', '.yaml', '.yml', '.txt']);
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+function slugify(name) {
+  return name
+    .replace(/\.md$/i, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+const PLUGIN_EMOJIS = {
+  'agent-sdk-dev':             '🤖',
+  'claude-opus-4-5-migration': '⬆️',
+  'code-review':               '🔍',
+  'commit-commands':           '📦',
+  'explanatory-output-style':  '📝',
+  'feature-dev':               '🚀',
+  'frontend-design':           '🎨',
+  'hookify':                   '🪝',
+  'learning-output-style':     '📚',
+  'finance-core':              '📈',
+  'os-tools':                  '🖥️',
+  'plugin-dev':                '🔌',
+  'pr-review-toolkit':         '🔎',
+  'ralph-wiggum':              '🎭',
+  'security-guidance':         '🔒',
+  'global':                    '🌐',
+};
+
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+  if (!match) return { name: '', description: '', argumentHint: '', allowedTools: [], body: content };
+
+  const fm   = match[1];
+  const body = match[2] ?? '';
+
+  let name = '';
+  const np = fm.match(/^name:\s*(.+)$/m);
+  if (np) name = np[1].trim().replace(/^["']|["']$/g, '');
+
+  let description = '';
+  const dq = fm.match(/^description:\s*"((?:[^"\\]|\\.)*)"\s*$/m);
+  if (dq) {
+    description = dq[1].replace(/\\"/g, '"');
+  } else {
+    const dp = fm.match(/^description:\s*(.+)$/m);
+    if (dp) description = dp[1].trim().replace(/^["']|["']$/g, '');
+  }
+
+  let argumentHint = '';
+  const ah = fm.match(/^argument-hint:\s*(.+)$/m);
+  if (ah) argumentHint = ah[1].trim().replace(/^["'\[]|["'\]]$/g, '');
+
+  let allowedTools = [];
+  const atLine = fm.match(/^allowed-tools:\s*([\s\S]*?)(?=\n\S|$)/m);
+  if (atLine) {
+    const raw = atLine[1].trim();
+    if (raw.startsWith('[')) {
+      try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) allowedTools = parsed.map(String);
+      } catch {
+        allowedTools = raw.replace(/^\[|\]$/g, '').split(',')
+          .map(s => s.trim().replace(/^"|"$/g, '')).filter(Boolean);
+      }
+    } else {
+      allowedTools = raw.split(',').map(s => s.trim()).filter(Boolean);
+    }
+  }
+
+  return { name, description, argumentHint, allowedTools, body };
+}
+
+function buildEntry(filePath, fileName, pluginName, idPrefix, extraTags) {
+  let content;
+  try { content = fs.readFileSync(filePath, 'utf8'); } catch { return null; }
+
+  const { name: fmName, description, argumentHint, allowedTools, body } = parseFrontmatter(content);
+  const fileSlug    = slugify(fileName);
+  const id          = `${idPrefix}-${fileSlug}`;
+  const emoji       = PLUGIN_EMOJIS[pluginName] ?? '🔧';
+  const displayName = fmName || fileSlug.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+
+  return {
+    id,
+    name:         displayName,
+    description:  description || displayName,
+    emoji,
+    tags:         ['imported', 'claude-code', pluginName, ...extraTags],
+    pluginName,
+    commandFile:  fileName,
+    allowedTools,
+    argumentHint,
+    promptBody:   body,
+    hasScripts:   false,
+    requires:     {},
+  };
+}
+
+// ── Loaders ──────────────────────────────────────────────────────────────────
+
+function loadDir(dir, pluginName, idPrefix, extraTags) {
+  if (!fs.existsSync(dir)) return [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const skills = [];
+  for (const entry of entries) {
+    if (!entry.isFile()) continue;
+    if (SKIP_FILES.has(entry.name)) continue;
+    if (!ALLOWED_EXTENSIONS.has(path.extname(entry.name))) continue;
+    if (!entry.name.endsWith('.md')) continue;
+    const skill = buildEntry(path.join(dir, entry.name), entry.name, pluginName, idPrefix, extraTags);
+    if (skill) skills.push(skill);
+  }
+  return skills;
+}
+
+function loadSkillsRecursive(skillsDir, pluginName) {
+  if (!fs.existsSync(skillsDir)) return [];
+  const results = [];
+
+  function walk(dir) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (!SKIP_DIRS.has(entry.name)) walk(path.join(dir, entry.name));
+      } else if (entry.isFile() && entry.name === 'SKILL.md') {
+        const rel     = path.relative(skillsDir, path.join(dir, entry.name));
+        const relSlug = rel.replace(/[\\/]/g, '-').replace(/\.md$/i, '').toLowerCase().replace(/[^a-z0-9-]+/g, '-');
+        const skill   = buildEntry(
+          path.join(dir, entry.name),
+          entry.name,
+          pluginName,
+          `cc-${slugify(pluginName)}-skill-${relSlug}`,
+          ['skill'],
+        );
+        if (skill) {
+          skill.id = `cc-${slugify(pluginName)}-skill-${relSlug}`;
+          results.push(skill);
+        }
+      }
+    }
+  }
+
+  walk(skillsDir);
+  return results;
+}
+
+function loadHooks(hooksDir, pluginName) {
+  if (!fs.existsSync(hooksDir)) return [];
+  const entries = fs.readdirSync(hooksDir, { withFileTypes: true });
+  const skills = [];
+  for (const entry of entries) {
+    if (!entry.isFile()) continue;
+    if (SKIP_FILES.has(entry.name)) continue;
+    if (!ALLOWED_EXTENSIONS.has(path.extname(entry.name))) continue;
+    const skill = buildEntry(
+      path.join(hooksDir, entry.name),
+      entry.name,
+      pluginName,
+      `cc-${slugify(pluginName)}-hook`,
+      ['hook'],
+    );
+    if (skill) skills.push(skill);
+  }
+  return skills;
+}
+
+// ── Main scan ────────────────────────────────────────────────────────────────
+
+function scan() {
+  if (!fs.existsSync(SKILLS_BASE)) {
+    console.error(`[bundle-skills] ERROR: must-b-skills/ not found at ${SKILLS_BASE}`);
+    process.exit(1);
+  }
+
+  const all = [];
+
+  // Global .claude/commands/
+  const globalCmds = path.join(SKILLS_BASE, '.claude', 'commands');
+  all.push(...loadDir(globalCmds, 'global', 'cc-global', ['command', 'global']));
+
+  // Per-plugin
+  const pluginsRoot = path.join(SKILLS_BASE, 'plugins');
+  if (fs.existsSync(pluginsRoot)) {
+    for (const entry of fs.readdirSync(pluginsRoot, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      if (SKIP_DIRS.has(entry.name)) continue;
+      const pluginDir  = path.join(pluginsRoot, entry.name);
+      const pluginName = entry.name;
+      const pSlug      = slugify(pluginName);
+
+      all.push(...loadDir(path.join(pluginDir, 'commands'), pluginName, `cc-${pSlug}`, ['command']));
+      all.push(...loadDir(path.join(pluginDir, 'agents'),   pluginName, `cc-${pSlug}-agent`, ['agent']));
+      all.push(...loadSkillsRecursive(path.join(pluginDir, 'skills'), pluginName));
+      all.push(...loadHooks(path.join(pluginDir, 'hooks'), pluginName));
+    }
+  }
+
+  // Deduplicate by id
+  const seen   = new Set();
+  const deduped = all.filter(s => {
+    if (seen.has(s.id)) return false;
+    seen.add(s.id);
+    return true;
+  });
+  deduped.sort((a, b) => a.id.localeCompare(b.id));
+  return deduped;
+}
+
+// ── Write output ─────────────────────────────────────────────────────────────
+
+const skills  = scan();
+const bundle  = {
+  version:     '1.71.4',
+  generatedAt: new Date().toISOString(),
+  count:        skills.length,
+  skills,
+};
+
+fs.mkdirSync(path.dirname(OUT_FILE), { recursive: true });
+fs.writeFileSync(OUT_FILE, JSON.stringify(bundle, null, 2), 'utf8');
+
+console.log(`[bundle-skills] ✓ Compiled ${skills.length} skills → ${path.relative(ROOT, OUT_FILE)}`);

package/scripts/create-must-b-shim.mjs

@@ -0,0 +1,45 @@
+/**
+ * Recreates node_modules/must-b/ after every npm install.
+ * The must-b package shim maps ./plugin-sdk/* to the internal TypeScript
+ * source tree so that channel extensions can import from "must-b/plugin-sdk/*"
+ * without a separate published npm package.
+ *
+ * Global installs (npm install -g) run postinstall with elevated file-system
+ * restrictions — writing to node_modules may be denied with EACCES or EPERM.
+ * The shim is best-effort: a permission failure is logged as a warning and the
+ * install continues cleanly. Channel extensions will not load without the shim,
+ * but all core Must-b features remain fully operational.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root   = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+const shimDir = path.join(root, 'node_modules', 'must-b');
+
+const shimPkg = JSON.stringify({
+  name: 'must-b',
+  version: '1.0.0',
+  exports: {
+    './plugin-sdk/*': '../../src/core/source/plugin-sdk/*.ts',
+  },
+}, null, 2);
+
+try {
+  fs.mkdirSync(shimDir, { recursive: true });
+  fs.writeFileSync(path.join(shimDir, 'package.json'), shimPkg);
+  console.log('[postinstall] must-b plugin-sdk shim written →', shimDir);
+} catch (err) {
+  const code = err && err.code;
+  if (code === 'EACCES' || code === 'EPERM' || code === 'EROFS') {
+    console.warn(
+      '[postinstall] WARNING: Could not write must-b shim to node_modules ' +
+      `(${code} — likely a global npm install with strict permissions).\n` +
+      '  Channel extensions may not load. All core Must-b features are unaffected.\n' +
+      '  To enable extensions, run: npm install --prefix <your-project-dir>'
+    );
+  } else {
+    // Unexpected error — surface it but still don't crash the install
+    console.warn('[postinstall] WARNING: must-b shim creation failed:', err && err.message || err);
+  }
+}

package/scripts/install.ps1

@@ -0,0 +1,113 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Must-b Installer for Windows (PowerShell)
+.DESCRIPTION
+    Downloads and installs Must-b — the Autonomous AI Platform.
+    Usage: iex (irm https://must-b.com/install.ps1)
+           — or —
+           pwsh scripts/install.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+
+$REPO       = "https://github.com/aytac43-0/Must-b"
+$INSTALL_DIR = Join-Path $env:USERPROFILE ".must-b"
+$NODE_MIN    = 20
+
+# ── UI helpers ───────────────────────────────────────────────────────────
+function Header($msg) { Write-Host "`n  $msg" -ForegroundColor DarkYellow }
+function Ok($msg)     { Write-Host "  [OK] $msg" -ForegroundColor Green }
+function Fail($msg)   { Write-Host "  [ERROR] $msg" -ForegroundColor Red; exit 1 }
+
+Write-Host @"
+
+  __  __           _          _
+ |  \/  |_   _ ___| |_       | |__
+ | |\/| | | | / __| __|  __  | '_ \
+ | |  | | |_| \__ \ |_  /  \ | |_) |
+ |_|  |_|\__,_|___/\__| \__/ |_.__/
+           Autonomous AI Platform
+
+"@ -ForegroundColor DarkYellow
+
+# ── Prerequisites ─────────────────────────────────────────────────────────
+Header "Checking prerequisites..."
+
+# Node.js
+$nodePath = Get-Command node -ErrorAction SilentlyContinue
+if (-not $nodePath) {
+    Fail "Node.js not found. Install Node.js $NODE_MIN+ from https://nodejs.org and re-run."
+}
+$nodeVersion = (node -e "process.stdout.write(process.version.slice(1))").Trim()
+$nodeMajor   = [int]($nodeVersion.Split(".")[0])
+if ($nodeMajor -lt $NODE_MIN) {
+    Fail "Node.js $NODE_MIN+ required (found v$nodeVersion). Please upgrade."
+}
+Ok "Node.js v$nodeVersion"
+
+# Git
+$gitPath = Get-Command git -ErrorAction SilentlyContinue
+if (-not $gitPath) {
+    Fail "git not found. Install Git from https://git-scm.com and re-run."
+}
+Ok "git $(git --version)"
+
+# npm
+$npmPath = Get-Command npm -ErrorAction SilentlyContinue
+if (-not $npmPath) { Fail "npm not found." }
+Ok "npm $(npm --version)"
+
+# ── Clone / update ────────────────────────────────────────────────────────
+Header "Installing Must-b to $INSTALL_DIR..."
+
+if (Test-Path (Join-Path $INSTALL_DIR ".git")) {
+    Write-Host "  Existing installation found — pulling latest..."
+    git -C $INSTALL_DIR pull --ff-only
+} else {
+    git clone --depth 1 $REPO $INSTALL_DIR
+}
+Ok "Repository ready"
+
+# ── Install dependencies ──────────────────────────────────────────────────
+Header "Installing backend dependencies..."
+Set-Location $INSTALL_DIR
+npm install --prefer-offline --omit=dev
+Ok "Backend dependencies installed"
+
+Header "Installing frontend dependencies..."
+Set-Location (Join-Path $INSTALL_DIR "public\must-b-ui")
+npm install --prefer-offline --omit=dev
+Ok "Frontend dependencies installed"
+
+# ── Create launcher (must-b.cmd) ──────────────────────────────────────────
+Header "Creating launcher..."
+$binDir   = Join-Path $env:USERPROFILE "AppData\Local\Programs\must-b\bin"
+$launcher = Join-Path $binDir "must-b.cmd"
+New-Item -ItemType Directory -Force -Path $binDir | Out-Null
+
+@"
+@echo off
+cd /d "$INSTALL_DIR"
+node --experimental-specifier-resolution=node dist/index.js %*
+"@ | Set-Content $launcher -Encoding ASCII
+
+# Add to user PATH if not already present
+$userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+if ($userPath -notlike "*$binDir*") {
+    [Environment]::SetEnvironmentVariable("PATH", "$userPath;$binDir", "User")
+    Write-Host "  Added $binDir to user PATH"
+}
+Ok "Launcher created at $launcher"
+
+# ── Done ─────────────────────────────────────────────────────────────────
+Set-Location $INSTALL_DIR
+Write-Host ""
+Write-Host "  Must-b installed successfully!" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Start the gateway:   must-b"
+Write-Host "  Open in browser:     http://localhost:4309"
+Write-Host "  Run setup wizard:    must-b onboard"
+Write-Host ""
+Write-Host "  Tip: restart your terminal for the PATH change to take effect."
+Write-Host ""

package/scripts/install.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# ────────────────────────────────────────────────────────────────────────────
+#  Must-b Installer — Linux / macOS
+#  Usage:   curl -fsSL https://must-b.com/install.sh | bash
+#           — or —
+#           bash scripts/install.sh
+# ────────────────────────────────────────────────────────────────────────────
+set -euo pipefail
+
+REPO="https://github.com/aytac43-0/Must-b"
+INSTALL_DIR="$HOME/.must-b"
+NODE_MIN_MAJOR=20
+BOLD="\033[1m"
+ORANGE="\033[38;5;208m"
+GREEN="\033[0;32m"
+RED="\033[0;31m"
+RESET="\033[0m"
+
+header() { echo -e "\n${ORANGE}${BOLD}▸ $*${RESET}"; }
+ok()     { echo -e "  ${GREEN}✓${RESET} $*"; }
+fail()   { echo -e "  ${RED}✗ $*${RESET}"; exit 1; }
+
+echo -e "\n${ORANGE}${BOLD}"
+cat <<'BANNER'
+  __  __           _          _
+ |  \/  |_   _ ___| |_       | |__
+ | |\/| | | | / __| __|  __  | '_ \
+ | |  | | |_| \__ \ |_  /  \ | |_) |
+ |_|  |_|\__,_|___/\__| \__/ |_.__/
+           Autonomous AI Platform
+BANNER
+echo -e "${RESET}"
+
+# ── Prerequisites ─────────────────────────────────────────────────────────
+header "Checking prerequisites…"
+
+# Node.js
+if ! command -v node &>/dev/null; then
+  fail "Node.js not found. Install Node.js ${NODE_MIN_MAJOR}+ from https://nodejs.org and re-run."
+fi
+NODE_MAJOR=$(node -e "process.stdout.write(process.version.slice(1).split('.')[0])")
+if [ "$NODE_MAJOR" -lt "$NODE_MIN_MAJOR" ]; then
+  fail "Node.js ${NODE_MIN_MAJOR}+ required (found v${NODE_MAJOR}). Please upgrade."
+fi
+ok "Node.js $(node --version)"
+
+# Git
+if ! command -v git &>/dev/null; then
+  fail "git not found. Please install git and re-run."
+fi
+ok "git $(git --version | awk '{print $3}')"
+
+# npm
+if ! command -v npm &>/dev/null; then
+  fail "npm not found."
+fi
+ok "npm $(npm --version)"
+
+# ── Clone / update ────────────────────────────────────────────────────────
+header "Installing Must-b to ${INSTALL_DIR}…"
+
+if [ -d "$INSTALL_DIR/.git" ]; then
+  echo "  Existing installation found — pulling latest…"
+  git -C "$INSTALL_DIR" pull --ff-only
+else
+  git clone --depth 1 "$REPO" "$INSTALL_DIR"
+fi
+ok "Repository ready"
+
+# ── Install dependencies ──────────────────────────────────────────────────
+header "Installing backend dependencies…"
+cd "$INSTALL_DIR"
+npm install --prefer-offline --omit=dev
+ok "Backend dependencies installed"
+
+header "Installing frontend dependencies…"
+cd "$INSTALL_DIR/public/must-b-ui"
+npm install --prefer-offline --omit=dev
+ok "Frontend dependencies installed"
+
+# ── Create launcher ───────────────────────────────────────────────────────
+header "Creating launcher…"
+LAUNCHER="$HOME/.local/bin/must-b"
+mkdir -p "$(dirname "$LAUNCHER")"
+
+cat > "$LAUNCHER" <<EOF
+#!/usr/bin/env bash
+cd "$INSTALL_DIR"
+exec node --experimental-specifier-resolution=node dist/index.js "\$@"
+EOF
+chmod +x "$LAUNCHER"
+
+# Add ~/.local/bin to PATH hint
+SHELL_RC=""
+case "$SHELL" in
+  */zsh)  SHELL_RC="$HOME/.zshrc" ;;
+  */bash) SHELL_RC="$HOME/.bashrc" ;;
+esac
+if [ -n "$SHELL_RC" ] && ! grep -q '.local/bin' "$SHELL_RC" 2>/dev/null; then
+  echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$SHELL_RC"
+  echo "  Added ~/.local/bin to PATH in ${SHELL_RC}"
+fi
+ok "Launcher created at ${LAUNCHER}"
+
+# ── Done ─────────────────────────────────────────────────────────────────
+echo -e "\n${GREEN}${BOLD}Must-b installed successfully!${RESET}\n"
+echo "  Start the gateway:   must-b"
+echo "  Open in browser:     http://localhost:4309"
+echo "  Run setup wizard:    must-b onboard"
+echo ""
+echo "  Tip: restart your terminal (or run: source ${SHELL_RC:-~/.bashrc})"
+echo ""

package/scripts/paparazzi.mjs

@@ -0,0 +1,92 @@
+/**
+ * paparazzi.mjs — Must-b UI Screenshot Utility
+ *
+ * Usage: node scripts/paparazzi.mjs
+ *
+ * Requires Must-b to be running on localhost:4309.
+ * Saves screenshots to screenshots/<route_name>.png (git + npm ignored).
+ */
+
+import { chromium }      from 'playwright';
+import fs                from 'fs';
+import path              from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT      = path.resolve(__dirname, '..');
+const OUT_DIR   = path.join(ROOT, 'screenshots');
+const BASE_URL  = 'http://localhost:4309';
+
+const ROUTES = [
+  { name: 'browser',     path: '/app/browser'     },
+  { name: 'automations', path: '/app/automations'  },
+  { name: 'skills',      path: '/app/skills'       },
+  { name: 'plugins',     path: '/app/plugins'      },
+  { name: 'files',       path: '/app/files'        },
+  { name: 'memory',      path: '/app/memory'       },
+  { name: 'settings',    path: '/app/settings'     },
+  { name: 'keys',        path: '/app/settings'     },  // settings hosts API keys
+];
+
+// ── Wait for server ──────────────────────────────────────────────────────────
+async function waitForServer(timeoutMs = 20_000) {
+  const start = Date.now();
+  process.stdout.write(`  Waiting for ${BASE_URL} `);
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const r = await fetch(`${BASE_URL}/api/setup/status`, { signal: AbortSignal.timeout(1200) });
+      if (r.status < 500) { process.stdout.write(' ready!\n'); return; }
+    } catch { /* not up yet */ }
+    await new Promise(r => setTimeout(r, 400));
+    process.stdout.write('.');
+  }
+  process.stdout.write('\n');
+  throw new Error(`Server not responding after ${timeoutMs}ms — start Must-b first.`);
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+  console.log('\n  Must-b Paparazzi\n  ─────────────────────────');
+
+  await waitForServer();
+  fs.mkdirSync(OUT_DIR, { recursive: true });
+
+  const browser = await chromium.launch({ headless: true });
+  const context = await browser.newContext({
+    viewport:          { width: 1440, height: 900 },
+    colorScheme:       'dark',
+    deviceScaleFactor: 1,
+  });
+  const page = await context.newPage();
+
+  // Dismiss any JS alerts automatically
+  page.on('dialog', d => d.dismiss().catch(() => {}));
+
+  let ok = 0, fail = 0;
+
+  for (const route of ROUTES) {
+    const url     = BASE_URL + route.path;
+    const outFile = path.join(OUT_DIR, `${route.name}.png`);
+    process.stdout.write(`  → ${(route.path).padEnd(24)}`);
+    try {
+      await page.goto(url, { waitUntil: 'networkidle', timeout: 25_000 });
+      // Extra settle for animations and deferred fetches
+      await page.waitForTimeout(1800);
+      await page.screenshot({ path: outFile, fullPage: false });
+      process.stdout.write(` ✓  screenshots/${route.name}.png\n`);
+      ok++;
+    } catch (e) {
+      process.stdout.write(` ✗  ${String(e.message).split('\n')[0]}\n`);
+      fail++;
+    }
+  }
+
+  await browser.close();
+
+  console.log(`\n  ─────────────────────────`);
+  console.log(`  Done — ${ok} captured, ${fail} failed.`);
+  if (ok > 0) console.log(`  Folder: ${OUT_DIR}`);
+  console.log();
+}
+
+main().catch(err => { console.error('\n  Error:', err.message); process.exit(1); });