slashvibe-mcp 0.3.19 → 0.3.21

package/tools/health.js

@@ -0,0 +1,87 @@
+/**
+ * vibe_health — Check /vibe platform health status
+ *
+ * Shows service status, latency, and user stats.
+ * Useful for debugging connection issues or monitoring uptime.
+ */
+
+const config = require('../config');
+
+const API_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+
+const definition = {
+  name: 'vibe_health',
+  description: 'Check /vibe platform health and service status',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      full: {
+        type: 'boolean',
+        description: 'Include detailed service checks (default: false)'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const { full = false } = args;
+
+  try {
+    const endpoint = `${API_URL}/api/health${full ? '?full=true' : ''}`;
+    const response = await fetch(endpoint);
+    const data = await response.json();
+
+    let display = `## /vibe Health Check\n\n`;
+
+    // Overall status
+    const statusEmoji = data.status === 'healthy' ? '\u2705' : data.status === 'degraded' ? '\u26a0\ufe0f' : '\u274c';
+    display += `**Status:** ${statusEmoji} ${data.status.toUpperCase()}\n`;
+    display += `**Version:** ${data.version}\n`;
+    display += `**Response Time:** ${data.responseTime}ms\n\n`;
+
+    // Service checks
+    if (data.checks) {
+      display += `### Services\n\n`;
+      display += `| Service | Status | Latency |\n`;
+      display += `|---------|--------|--------|\n`;
+
+      for (const [service, check] of Object.entries(data.checks)) {
+        const emoji = check.status === 'healthy' ? '\u2705' : check.status === 'not_configured' ? '\u2796' : '\u274c';
+        const latency = check.latency ? `${check.latency}ms` : '-';
+        display += `| ${service} | ${emoji} ${check.status} | ${latency} |\n`;
+      }
+      display += '\n';
+    }
+
+    // Stats (only in full mode)
+    if (data.stats) {
+      display += `### Platform Stats\n\n`;
+      display += `- **Registered Handles:** ${data.stats.registeredHandles}\n`;
+      display += `- **Active This Week:** ${data.stats.activeThisWeek}\n`;
+      display += `- **Total Tips:** ${data.stats.totalTips}\n\n`;
+    }
+
+    // Vibe Beats (activity metrics)
+    if (data.vibeBeats) {
+      display += `### Vibe Beats (Activity)\n\n`;
+      display += `| Period | Active Users |\n`;
+      display += `|--------|-------------|\n`;
+      display += `| Online (30 min) | ${data.vibeBeats.online} |\n`;
+      display += `| Hourly | ${data.vibeBeats.hourly} |\n`;
+      display += `| Daily (DAU) | ${data.vibeBeats.daily} |\n`;
+      display += `| Weekly (WAU) | ${data.vibeBeats.weekly} |\n`;
+      display += `| Monthly (MAU) | ${data.vibeBeats.monthly} |\n`;
+    }
+
+    display += `\n_Checked at ${data.timestamp}_`;
+
+    return { display };
+
+  } catch (e) {
+    return {
+      display: `## /vibe Health Check\n\n\u274c **Connection Failed**\n\nError: ${e.message}\n\nMake sure you have internet connectivity and try again.`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/leaderboard.js

@@ -0,0 +1,117 @@
+/**
+ * vibe_leaderboard — See top builders on /vibe
+ *
+ * Shows the leaderboard ranked by Vibe Score:
+ * - Ships posted (building stuff)
+ * - Reactions received (quality signal)
+ * - Comments given (helping others)
+ * - Streak consistency (showing up)
+ * - Invites redeemed (growing community)
+ */
+
+const config = require('../config');
+
+const API_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+
+const definition = {
+  name: 'vibe_leaderboard',
+  description: 'See top builders on /vibe ranked by Vibe Score',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      category: {
+        type: 'string',
+        enum: ['overall', 'ships', 'streaks', 'reactions', 'helpful'],
+        description: 'Leaderboard category (default: overall)'
+      },
+      limit: {
+        type: 'number',
+        description: 'Number of entries to show (default: 10, max: 50)'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const { category = 'overall', limit = 10 } = args;
+  const maxLimit = Math.min(limit, 50);
+
+  try {
+    const endpoint = `${API_URL}/api/growth/leaderboard?category=${category}&limit=${maxLimit}`;
+    const response = await fetch(endpoint);
+    const data = await response.json();
+
+    if (!data.success) {
+      return { display: `\u274c Failed to load leaderboard: ${data.error}` };
+    }
+
+    const myHandle = config.isInitialized() ? config.getHandle() : null;
+
+    let display = `## /vibe Leaderboard\n`;
+    display += `**Category:** ${category} | **Showing:** Top ${maxLimit}\n\n`;
+
+    if (data.leaderboard.length === 0) {
+      display += `_No entries yet. Be the first to ship!_\n`;
+      return { display };
+    }
+
+    // Table header
+    display += `| Rank | Builder | Vibe Score | Ships | Streak |\n`;
+    display += `|------|---------|------------|-------|--------|\n`;
+
+    for (const entry of data.leaderboard) {
+      const isMe = myHandle && entry.handle.toLowerCase() === myHandle.toLowerCase();
+      const highlight = isMe ? '**' : '';
+
+      // Position change indicator
+      let posIndicator = '';
+      if (entry.positionChange > 0) {
+        posIndicator = ` \u2191${entry.positionChange}`;
+      } else if (entry.positionChange < 0) {
+        posIndicator = ` \u2193${Math.abs(entry.positionChange)}`;
+      } else if (entry.isNew) {
+        posIndicator = ' \u2728';
+      }
+
+      // Tier emoji
+      const tierEmoji = entry.tierDisplay?.emoji || '';
+
+      display += `| ${highlight}#${entry.rank}${posIndicator}${highlight} | ${highlight}@${entry.handle}${highlight} ${tierEmoji} | ${entry.vibeScore} | ${entry.stats?.ships || 0} | ${entry.streak || 0}d |\n`;
+    }
+
+    // Stats summary
+    if (data.stats) {
+      display += `\n### Community Stats\n`;
+      display += `- **Total Builders:** ${data.stats.total}\n`;
+      display += `- **Ships Posted:** ${data.stats.shipsCount}\n`;
+      display += `- **Active Today:** ${data.stats.activeToday}\n`;
+      display += `- **Avg Vibe Score:** ${data.stats.averageVibeScore}\n`;
+    }
+
+    // Highlights
+    if (data.highlights?.movers?.length > 0) {
+      display += `\n### \ud83d\ude80 Biggest Movers\n`;
+      for (const mover of data.highlights.movers.slice(0, 3)) {
+        display += `- @${mover.handle} +${mover.change} (now #${mover.rank})\n`;
+      }
+    }
+
+    if (data.highlights?.newEntries?.length > 0) {
+      display += `\n### \u2728 New Entries\n`;
+      for (const entry of data.highlights.newEntries.slice(0, 3)) {
+        display += `- @${entry.handle} joined at #${entry.rank}\n`;
+      }
+    }
+
+    display += `\n_${data.note}_`;
+
+    return { display };
+
+  } catch (e) {
+    return {
+      display: `## /vibe Leaderboard\n\n\u274c **Failed to load**\n\nError: ${e.message}`
+    };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/lib/git-apply.js

@@ -0,0 +1,206 @@
+/**
+ * Git Apply Library
+ *
+ * Downloads and applies git bundles from session forks.
+ * Used by session.js fork command to get actual code.
+ *
+ * Key functions:
+ * - downloadBundle(url) - Download bundle from signed URL
+ * - applyBundleFromUrl(url, branchName) - Download and apply in one step
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+const http = require('http');
+
+const { isGitRepo, validateBundle, applyBundle } = require('./git-bundle');
+
+/**
+ * Download a bundle from a URL
+ * @param {string} url - The signed download URL
+ * @returns {Promise<object>} - { success, buffer, error? }
+ */
+async function downloadBundle(url) {
+  return new Promise((resolve) => {
+    const protocol = url.startsWith('https') ? https : http;
+
+    const request = protocol.get(url, (response) => {
+      // Handle redirects
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        downloadBundle(response.headers.location).then(resolve);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        resolve({
+          success: false,
+          error: `HTTP ${response.statusCode}: ${response.statusMessage}`,
+        });
+        return;
+      }
+
+      const chunks = [];
+      response.on('data', (chunk) => chunks.push(chunk));
+      response.on('end', () => {
+        const buffer = Buffer.concat(chunks);
+        resolve({
+          success: true,
+          buffer,
+          size: buffer.length,
+        });
+      });
+      response.on('error', (err) => {
+        resolve({ success: false, error: err.message });
+      });
+    });
+
+    request.on('error', (err) => {
+      resolve({ success: false, error: err.message });
+    });
+
+    // Timeout after 60 seconds
+    request.setTimeout(60000, () => {
+      request.destroy();
+      resolve({ success: false, error: 'Download timeout (60s)' });
+    });
+  });
+}
+
+/**
+ * Download and apply a bundle from a URL
+ * @param {string} url - The signed download URL
+ * @param {string} branchName - Name for the new branch (default: 'forked-session')
+ * @returns {Promise<object>} - { success, branch, commits?, error? }
+ */
+async function applyBundleFromUrl(url, branchName = 'forked-session') {
+  // Check we're in a git repo
+  if (!isGitRepo()) {
+    return { success: false, error: 'Not in a git repository' };
+  }
+
+  // Download the bundle
+  console.log(`[git-apply] Downloading bundle...`);
+  const downloadResult = await downloadBundle(url);
+
+  if (!downloadResult.success) {
+    return { success: false, error: `Download failed: ${downloadResult.error}` };
+  }
+
+  console.log(`[git-apply] Downloaded ${downloadResult.size} bytes`);
+
+  // Validate the bundle
+  const validation = validateBundle(downloadResult.buffer);
+  if (!validation.success) {
+    return { success: false, error: `Invalid bundle: ${validation.error}` };
+  }
+
+  // Apply the bundle
+  console.log(`[git-apply] Applying bundle to branch: ${branchName}`);
+  const applyResult = applyBundle(downloadResult.buffer, branchName);
+
+  if (!applyResult.success) {
+    return { success: false, error: `Apply failed: ${applyResult.error}` };
+  }
+
+  return {
+    success: true,
+    branch: applyResult.branch,
+    refs: applyResult.refs,
+    size: downloadResult.size,
+    message: `Bundle applied to branch '${applyResult.branch}'. Use 'git checkout ${applyResult.branch}' to view.`,
+  };
+}
+
+/**
+ * Check out the forked branch
+ * @param {string} branchName - Branch to checkout
+ * @returns {object} - { success, error? }
+ */
+function checkoutBranch(branchName) {
+  try {
+    execSync(`git checkout ${branchName}`, {
+      stdio: 'pipe',
+      encoding: 'utf8',
+    });
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * Get info about a branch
+ * @param {string} branchName - Branch name
+ * @returns {object} - { exists, current, commits? }
+ */
+function getBranchInfo(branchName) {
+  try {
+    // Check if branch exists
+    const branches = execSync('git branch --list', {
+      stdio: 'pipe',
+      encoding: 'utf8',
+    });
+
+    const branchList = branches.split('\n').map((b) => b.replace(/^\*?\s*/, '').trim());
+    const exists = branchList.includes(branchName);
+
+    // Check current branch
+    const currentBranch = execSync('git rev-parse --abbrev-ref HEAD', {
+      stdio: 'pipe',
+      encoding: 'utf8',
+    }).trim();
+
+    const result = {
+      exists,
+      current: currentBranch === branchName,
+      currentBranch,
+    };
+
+    // Get commit count if branch exists
+    if (exists) {
+      try {
+        const commitCount = execSync(`git rev-list --count ${branchName}`, {
+          stdio: 'pipe',
+          encoding: 'utf8',
+        });
+        result.commits = parseInt(commitCount.trim(), 10);
+      } catch (e) {
+        // Branch might not have commits yet
+      }
+    }
+
+    return result;
+  } catch (error) {
+    return { exists: false, current: false, error: error.message };
+  }
+}
+
+/**
+ * Delete a branch
+ * @param {string} branchName - Branch to delete
+ * @param {boolean} force - Force delete even if not merged
+ * @returns {object} - { success, error? }
+ */
+function deleteBranch(branchName, force = false) {
+  try {
+    const flag = force ? '-D' : '-d';
+    execSync(`git branch ${flag} ${branchName}`, {
+      stdio: 'pipe',
+      encoding: 'utf8',
+    });
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
+
+module.exports = {
+  downloadBundle,
+  applyBundleFromUrl,
+  checkoutBranch,
+  getBranchInfo,
+  deleteBranch,
+};