slashvibe-mcp 0.3.20 → 0.3.21

package/tools/_discovery.js

@@ -113,49 +113,142 @@ function calculateSkillComplementarity(tags1, tags2) {
   return { score, pairs: pairs.slice(0, 2) };
 }
 
+// Helper: Check for word boundary match (avoids "said" matching "ai", "start" matching "art")
+function hasWord(text, word) {
+  // Use word boundary regex for short keywords prone to false positives
+  const regex = new RegExp(`\\b${word}\\b`, 'i');
+  return regex.test(text);
+}
+
 // Suggest interests based on what user is building
 function suggestInterestsFromBuilding(buildingDescription) {
   if (!buildingDescription) return [];
-  
+
   const building = buildingDescription.toLowerCase();
   const suggestions = [];
-  
-  // AI/ML projects
-  if (building.includes('ai') || building.includes('machine learning') || building.includes('llm')) {
-    suggestions.push('ai', 'machine learning', 'deep learning');
+
+  // Agent/Automation projects (critical for /vibe users!)
+  if (building.includes('agent') || building.includes('automation') ||
+      hasWord(building, 'mcp') || building.includes('claude') ||
+      building.includes('orchestrat') || building.includes('workflow')) {
+    suggestions.push('agents', 'ai', 'automation');
   }
-  
+
+  // AI/ML projects (use word boundary for short keywords)
+  if (hasWord(building, 'ai') || building.includes('machine learning') ||
+      hasWord(building, 'llm') || hasWord(building, 'gpt') ||
+      building.includes('neural') || hasWord(building, 'ml')) {
+    suggestions.push('ai', 'machine learning');
+  }
+
   // Web projects
-  if (building.includes('web') || building.includes('website') || building.includes('app')) {
-    suggestions.push('web development', 'frontend', 'fullstack');
+  if (building.includes('web') || building.includes('website') ||
+      building.includes('frontend') || building.includes('react') ||
+      building.includes('next') || building.includes('vue')) {
+    suggestions.push('web development', 'frontend');
   }
-  
-  // Mobile projects  
-  if (building.includes('mobile') || building.includes('ios') || building.includes('android')) {
-    suggestions.push('mobile development', 'app development');
+
+  // Backend/API projects
+  if (building.includes('api') || building.includes('backend') ||
+      building.includes('server') || building.includes('database')) {
+    suggestions.push('backend', 'api');
   }
-  
+
+  // Mobile projects
+  if (building.includes('mobile') || building.includes('ios') ||
+      building.includes('android') || building.includes('flutter') ||
+      building.includes('react native')) {
+    suggestions.push('mobile development');
+  }
+
+  // Platform/SaaS projects (NEW)
+  if (building.includes('platform') || building.includes('saas') ||
+      building.includes('.app') || building.includes('product')) {
+    suggestions.push('platform', 'saas', 'product');
+  }
+
   // Startup/business projects
-  if (building.includes('startup') || building.includes('business') || building.includes('saas')) {
-    suggestions.push('startups', 'entrepreneur', 'product management');
+  if (building.includes('startup') || building.includes('business') ||
+      building.includes('founder') || building.includes('company')) {
+    suggestions.push('startups', 'entrepreneur');
   }
-  
+
   // Data projects
-  if (building.includes('data') || building.includes('analytics') || building.includes('dashboard')) {
-    suggestions.push('data science', 'analytics', 'visualization');
+  if (building.includes('data') || building.includes('analytics') ||
+      building.includes('dashboard') || building.includes('visualization')) {
+    suggestions.push('data science', 'analytics');
   }
-  
+
+  // Developer tools (NEW)
+  if (building.includes('tool') || building.includes('cli') ||
+      building.includes('developer') || building.includes('devtool') ||
+      building.includes('editor') || building.includes('ide')) {
+    suggestions.push('developer tools', 'infrastructure');
+  }
+
+  // Creative/Generative projects (NEW)
+  if (hasWord(building, 'art') || building.includes('generative') ||
+      building.includes('creative') || building.includes('music') ||
+      building.includes('visual') || building.includes('design')) {
+    suggestions.push('generative art', 'creative');
+  }
+
   // Content/media projects
-  if (building.includes('content') || building.includes('blog') || building.includes('media')) {
-    suggestions.push('content creation', 'writing', 'marketing');
+  if (building.includes('content') || building.includes('blog') ||
+      building.includes('media') || building.includes('writing')) {
+    suggestions.push('content creation', 'writing');
   }
-  
+
   // Gaming projects
-  if (building.includes('game') || building.includes('unity') || building.includes('gaming')) {
-    suggestions.push('game development', 'gaming', 'interactive media');
+  if (building.includes('game') || building.includes('unity') ||
+      building.includes('gaming') || building.includes('interactive')) {
+    suggestions.push('game development', 'gaming');
   }
-  
-  return [...new Set(suggestions)].slice(0, 4);
+
+  // Infrastructure/DevOps (NEW)
+  if (building.includes('infrastructure') || building.includes('devops') ||
+      building.includes('cloud') || building.includes('deploy') ||
+      building.includes('kubernetes') || building.includes('docker')) {
+    suggestions.push('devops', 'infrastructure');
+  }
+
+  // Social/Community (NEW)
+  if (building.includes('social') || building.includes('community') ||
+      building.includes('network') || building.includes('chat') ||
+      building.includes('messaging')) {
+    suggestions.push('social', 'community');
+  }
+
+  // Crypto/Web3 (NEW)
+  if (building.includes('crypto') || building.includes('web3') ||
+      building.includes('blockchain') || building.includes('defi') ||
+      building.includes('nft') || building.includes('token')) {
+    suggestions.push('crypto', 'web3');
+  }
+
+  // Education (NEW)
+  if (building.includes('education') || building.includes('learning') ||
+      building.includes('course') || building.includes('tutorial') ||
+      building.includes('teaching')) {
+    suggestions.push('education', 'learning');
+  }
+
+  // Fintech (NEW)
+  if (building.includes('fintech') || building.includes('payment') ||
+      building.includes('banking') || building.includes('finance') ||
+      building.includes('trading')) {
+    suggestions.push('fintech', 'finance');
+  }
+
+  // Health/Biotech (NEW)
+  if (building.includes('health') || building.includes('biotech') ||
+      building.includes('medical') || building.includes('fitness') ||
+      building.includes('wellness')) {
+    suggestions.push('healthtech', 'biotech');
+  }
+
+  // Return unique interests, limited to 5
+  return [...new Set(suggestions)].slice(0, 5);
 }
 
 // Suggest tags/skills based on interests and building

package/tools/_shared/index.js

@@ -7,10 +7,71 @@
  * - Time formatting
  * - Display formatting
  * - Error handling
+ * - Relevancy API fetching
  */
 
 const config = require('../../config');
 
+// ============ RELEVANCY API ============
+
+const RELEVANCY_API_TIMEOUT = 5000; // 5 seconds
+
+/**
+ * Fetch relevant users from the Universal Relevancy API
+ *
+ * @param {string} handle - The requesting user's handle
+ * @param {string} context - The context: 'discovery', 'dm_suggest', 'feed', 'notification'
+ * @param {number} limit - Max results (default 5)
+ * @returns {Promise<{ matches: object[], tier: string, fromApi: boolean } | null>}
+ */
+async function fetchRelevantUsers(handle, context = 'discovery', limit = 5) {
+  try {
+    const apiUrl = config.getApiUrl();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), RELEVANCY_API_TIMEOUT);
+
+    const url = `${apiUrl}/api/relevancy?handle=${encodeURIComponent(handle)}&context=${context}&limit=${limit}`;
+
+    const response = await fetch(url, {
+      method: 'GET',
+      headers: {
+        'Accept': 'application/json',
+        'User-Agent': 'vibe-mcp-client'
+      },
+      signal: controller.signal
+    });
+
+    clearTimeout(timeout);
+
+    if (!response.ok) {
+      console.log(`[relevancy] API returned ${response.status}`);
+      return null;
+    }
+
+    const data = await response.json();
+
+    if (!data.success || !data.matches) {
+      console.log('[relevancy] API returned unsuccessful response');
+      return null;
+    }
+
+    return {
+      matches: data.matches,
+      tier: data.tier,
+      socialStats: data.socialStats,
+      fromApi: true
+    };
+  } catch (e) {
+    // Log but don't fail - caller should handle null gracefully
+    if (e.name === 'AbortError') {
+      console.log('[relevancy] API timeout');
+    } else {
+      console.log('[relevancy] API error:', e.message);
+    }
+    return null;
+  }
+}
+
 // ============ INIT CHECK ============
 
 /**
@@ -231,6 +292,9 @@ function validateRequired(args, required) {
 }
 
 module.exports = {
+  // Relevancy
+  fetchRelevantUsers,
+
   // Init
   requireInit,
   withInit,

package/tools/_shared.js

@@ -0,0 +1,234 @@
+/**
+ * _shared.js — Common utilities for /vibe MCP tools
+ *
+ * This module provides shared helpers used across 90+ tools.
+ * Import only what you need to keep tool files clean.
+ */
+
+const config = require('../config');
+const store = require('../store');
+
+// ─────────────────────────────────────────────────────────────
+// Authentication & Initialization
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Check if user has initialized vibe. Returns error response if not.
+ * Use at the top of handler functions:
+ *   const initCheck = requireInit();
+ *   if (initCheck) return initCheck;
+ *
+ * @returns {Object|null} Error response object, or null if initialized
+ */
+function requireInit() {
+  if (!config.isInitialized()) {
+    return {
+      display: '⚠️ Not initialized. Run `vibe init` first.',
+      error: 'not_initialized'
+    };
+  }
+  return null;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Handle Normalization
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Normalize a handle string (remove @, lowercase, trim)
+ * @param {string} handle - Raw handle input
+ * @returns {string} Normalized handle
+ */
+function normalizeHandle(handle) {
+  if (!handle) return '';
+  return handle.toString().replace(/^@/, '').toLowerCase().trim();
+}
+
+/**
+ * Format handle for display (with @)
+ * @param {string} handle - Handle to format
+ * @returns {string} Display-formatted handle
+ */
+function displayHandle(handle) {
+  if (!handle) return '@unknown';
+  const normalized = normalizeHandle(handle);
+  return `@${normalized}`;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Time Formatting
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Format timestamp as relative time (e.g., "5m ago", "2h ago")
+ * @param {number} timestamp - Unix timestamp in milliseconds
+ * @returns {string} Human-readable relative time
+ */
+function formatTimeAgo(timestamp) {
+  if (timestamp === undefined || timestamp === null || isNaN(timestamp)) return 'unknown';
+
+  const now = Date.now();
+  const seconds = Math.floor((now - timestamp) / 1000);
+
+  if (seconds < 0 || isNaN(seconds)) return 'unknown';
+  if (seconds < 60) return 'just now';
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
+  return `${Math.floor(seconds / 86400)}d ago`;
+}
+
+/**
+ * Format duration in human-readable form
+ * @param {number} ms - Duration in milliseconds
+ * @returns {string} Human-readable duration (e.g., "5 minutes", "2 hours")
+ */
+function formatDuration(ms) {
+  if (!ms || ms < 0) return 'unknown';
+
+  const seconds = Math.floor(ms / 1000);
+  if (seconds < 60) return `${seconds} second${seconds !== 1 ? 's' : ''}`;
+
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes} minute${minutes !== 1 ? 's' : ''}`;
+
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours} hour${hours !== 1 ? 's' : ''}`;
+
+  const days = Math.floor(hours / 24);
+  return `${days} day${days !== 1 ? 's' : ''}`;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Text Formatting
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Truncate text to max length with ellipsis
+ * @param {string} text - Text to truncate
+ * @param {number} maxLength - Maximum length (default: 100)
+ * @returns {string} Truncated text
+ */
+function truncate(text, maxLength = 100) {
+  if (!text) return '';
+  if (text.length <= maxLength) return text;
+  return text.slice(0, maxLength - 3) + '...';
+}
+
+// ─────────────────────────────────────────────────────────────
+// Display Formatting (headers, dividers, status messages)
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Format a section header
+ * @param {string} text - Header text
+ * @returns {string} Formatted header
+ */
+function header(text) {
+  return `\n## ${text}\n`;
+}
+
+/**
+ * Horizontal divider
+ * @returns {string} Divider string
+ */
+function divider() {
+  return '\n---\n';
+}
+
+/**
+ * Format empty state message
+ * @param {string} message - Message to display
+ * @returns {string} Formatted empty state
+ */
+function emptyState(message) {
+  return `\n_${message}_\n`;
+}
+
+/**
+ * Format success message
+ * @param {string} message - Success message
+ * @returns {string} Formatted success message
+ */
+function success(message) {
+  return `✓ ${message}`;
+}
+
+/**
+ * Format warning message
+ * @param {string} message - Warning message
+ * @returns {string} Formatted warning message
+ */
+function warning(message) {
+  return `⚠️ ${message}`;
+}
+
+/**
+ * Format error message
+ * @param {string} message - Error message
+ * @returns {string} Formatted error message
+ */
+function error(message) {
+  return `❌ ${message}`;
+}
+
+// ─────────────────────────────────────────────────────────────
+// API Helpers
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * Fetch relevant users for a given context
+ * Uses the relevancy API to find people worth connecting with
+ *
+ * @param {string} handle - Current user's handle
+ * @param {string} context - Context type: 'dm_suggest', 'notification', etc.
+ * @param {number} limit - Max number of results (default: 5)
+ * @returns {Promise<{matches: Array}>} Relevant users with reasons
+ */
+async function fetchRelevantUsers(handle, context = 'dm_suggest', limit = 5) {
+  try {
+    const apiUrl = config.getApiUrl();
+    const response = await fetch(
+      `${apiUrl}/api/relevancy?handle=${encodeURIComponent(handle)}&context=${context}&limit=${limit}`
+    );
+
+    if (!response.ok) {
+      return { matches: [] };
+    }
+
+    return await response.json();
+  } catch (e) {
+    console.warn('[_shared] fetchRelevantUsers error:', e.message);
+    return { matches: [] };
+  }
+}
+
+// ─────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────
+
+module.exports = {
+  // Auth
+  requireInit,
+
+  // Handles
+  normalizeHandle,
+  displayHandle,
+
+  // Time
+  formatTimeAgo,
+  formatDuration,
+
+  // Text
+  truncate,
+
+  // Display
+  header,
+  divider,
+  emptyState,
+  success,
+  warning,
+  error,
+
+  // API
+  fetchRelevantUsers
+};