slashvibe-mcp 0.2.1 → 0.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Slash Vibe, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,69 +1,87 @@
-# vibe-mcp
+# /vibe MCP Server
 
-Social layer for Claude Code. DMs, presence, and connection between AI-assisted developers.
+The social layer for Claude Code. DMs, presence, and connection between AI developers.
+
+## What is /vibe?
+
+/vibe brings social connection to the terminal. While you're building with Claude Code, /vibe lets you:
+
+- **See who's online** - Know when other developers are in flow
+- **Send DMs** - Message fellow builders without leaving your terminal
+- **Share your presence** - Let others know what you're working on
+- **Build reputation** - Your sessions become proof of work
 
 ## Installation
 
 ```bash
-# Install globally
-npm install -g vibe-mcp
-
-# Or add to Claude Code MCP config
-claude mcp add vibe-mcp
+npx slashvibe-mcp
 ```
 
-## Manual Setup
-
-Add to `~/.claude.json`:
+Or add to your Claude Code MCP settings (`~/.claude.json`):
 
 ```json
 {
   "mcpServers": {
     "vibe": {
       "command": "npx",
-      "args": ["vibe-mcp"],
-      "env": {
-        "VIBE_API_URL": "https://www.slashvibe.dev"
-      }
+      "args": ["-y", "slashvibe-mcp"]
     }
   }
 }
 ```
 
-## Features
+## Quick Start
+
+1. Install the MCP server
+2. Authenticate: `vibe_auth` tool will guide you
+3. Check who's online: `vibe_presence`
+4. Send a message: `vibe_dm`
+
+## Available Tools
 
-- **Presence** - See who's online building with Claude Code
-- **DMs** - Direct messages between developers
-- **Memory** - Remember context about connections
-- **Status** - Share what you're working on
-- **Games** - Play tic-tac-toe while coding
+| Tool | Description |
+|------|-------------|
+| `vibe_auth` | Authenticate with slashvibe.dev |
+| `vibe_presence` | See who's online now |
+| `vibe_dm` | Send a direct message |
+| `vibe_inbox` | Check your messages |
+| `vibe_ship` | Announce what you shipped |
+| `vibe_idea` | Share an idea with the community |
+| `vibe_discover` | Find interesting builders |
+| `vibe_remember` | Save context about a connection |
+| `vibe_recall` | Recall memories about someone |
 
-## Commands
+## The Platform
 
-Once installed, use these in Claude Code:
+This MCP server connects to [slashvibe.dev](https://slashvibe.dev), where:
 
-| Command | Description |
-|---------|-------------|
-| `vibe` | Check inbox and see who's online |
-| `vibe who` | List online users |
-| `vibe dm @handle "message"` | Send a DM |
-| `vibe status shipping` | Set your status |
-| `vibe remember @handle "note"` | Save a memory |
-| `vibe recall @handle` | Recall memories |
+- Your identity persists across sessions
+- Your work builds reputation over time
+- The community grows through genuine connection
 
-## API
+## Philosophy
 
-The MCP server connects to `slashvibe.dev` for:
-- User presence and discovery
-- Message routing
-- Identity verification
+We believe AI development should be social, not solitary. The terminal is where real work happens - decisions, debugging, breakthroughs. /vibe makes that visible and connectable.
 
-## Related
+**Empathy. Collaboration. Shared value creation.**
 
-- [slashvibe.dev](https://slashvibe.dev) - Web presence
-- [Spirit Protocol](https://spiritprotocol.io) - Parent ecosystem
-- [AIRC](https://airc.chat) - Agent identity protocol
+## Contributing
+
+We welcome contributions! Please read our [Contributor License Agreement](./CLA.md) before submitting pull requests.
+
+- Report bugs via [GitHub Issues](https://github.com/VibeCodingInc/vibe-mcp/issues)
+- Propose features via [Discussions](https://github.com/VibeCodingInc/vibe-mcp/discussions)
+- Submit PRs for review
 
 ## License
 
-MIT
+MIT - see [LICENSE](./LICENSE)
+
+## Links
+
+- [slashvibe.dev](https://slashvibe.dev) - The platform
+- [Twitter](https://twitter.com/slashvibe) - Updates
+
+---
+
+Built with obsession by [Slash Vibe, Inc.](https://slashvibe.dev)

package/config.js

@@ -66,7 +66,15 @@ function save(config) {
     publicKey: config.publicKey || existing.publicKey || null,
     privateKey: config.privateKey || existing.privateKey || null,
     // Guided mode (AskUserQuestion menus)
-    guided_mode: config.guided_mode !== undefined ? config.guided_mode : existing.guided_mode
+    guided_mode: config.guided_mode !== undefined ? config.guided_mode : existing.guided_mode,
+    // Notification level
+    notifications: config.notifications || existing.notifications || null,
+    // GitHub Activity settings
+    github_activity_enabled: config.github_activity_enabled !== undefined ? config.github_activity_enabled : existing.github_activity_enabled,
+    github_activity_privacy: config.github_activity_privacy || existing.github_activity_privacy || null,
+    // Privy OAuth token (persisted across MCP process restarts)
+    privyToken: config.privyToken || existing.privyToken || null,
+    authMethod: config.authMethod || existing.authMethod || null
   };
   fs.writeFileSync(PRIMARY_CONFIG, JSON.stringify(data, null, 2));
 }
@@ -203,8 +211,77 @@ function setAuthToken(token, sessionId = null) {
 }
 
 function getAuthToken() {
+  // First check session data
+  const data = getSessionData();
+  if (data?.token) return data.token;
+
+  // Fall back to shared config (persisted across MCP process restarts)
+  const cfg = load();
+  return cfg?.privyToken || null;
+}
+
+/**
+ * Save Privy JWT token (used after browser OAuth flow)
+ * @param {string} token - Privy access token
+ */
+function savePrivyToken(token) {
+  // Save to session data
+  const data = getSessionData() || {};
+  saveSessionData({
+    ...data,
+    sessionId: data.sessionId || generateSessionId(),
+    token,
+    authMethod: 'privy'  // Track that this is a Privy token
+  });
+
+  // Also save to shared config for persistence across MCP restarts
+  const cfg = load();
+  cfg.privyToken = token;
+  cfg.authMethod = 'privy';
+  save(cfg);
+}
+
+/**
+ * Check if user has Privy auth (vs legacy keypair)
+ */
+function hasPrivyAuth() {
   const data = getSessionData();
-  return data?.token || null;
+  if (data?.authMethod === 'privy' && data?.token) return true;
+
+  const cfg = load();
+  return cfg?.authMethod === 'privy' && cfg?.privyToken;
+}
+
+/**
+ * Remove keypair after migration to Privy
+ * Clears private key from config (security improvement)
+ */
+function removeKeypair() {
+  const cfg = load();
+  delete cfg.publicKey;
+  delete cfg.privateKey;
+  save(cfg);
+
+  // Also clear from session
+  const data = getSessionData();
+  if (data) {
+    delete data.publicKey;
+    delete data.privateKey;
+    saveSessionData(data);
+  }
+}
+
+/**
+ * Get auth URL for browser-based GitHub OAuth
+ * @param {string|null} handle - Custom handle (optional - defaults to GitHub username)
+ */
+function getAuthUrl(handle = null) {
+  const apiUrl = getApiUrl();
+  if (handle) {
+    return `${apiUrl}/api/auth/github?handle=${encodeURIComponent(handle)}`;
+  }
+  // No handle = use GitHub username as handle
+  return `${apiUrl}/api/auth/github`;
 }
 
 function clearSession() {
@@ -228,6 +305,81 @@ function setGuidedMode(enabled) {
   save(config);
 }
 
+// Notification settings
+// Levels: "all" | "mentions" | "off"
+// - all: desktop + bell for unread, mentions, presence (default)
+// - mentions: only @mentions trigger notifications
+// - off: no notifications
+function getNotifications() {
+  const config = load();
+  return config.notifications || 'all';
+}
+
+function setNotifications(level) {
+  const validLevels = ['all', 'mentions', 'off'];
+  if (!validLevels.includes(level)) {
+    throw new Error(`Invalid notification level. Use: ${validLevels.join(', ')}`);
+  }
+  const config = load();
+  config.notifications = level;
+  save(config);
+}
+
+// GitHub Activity settings
+// Shows shipping status based on GitHub commit activity
+// Default: false (opt-in for privacy)
+function getGithubActivityEnabled() {
+  const config = load();
+  return config.github_activity_enabled === true;
+}
+
+function setGithubActivityEnabled(enabled) {
+  const config = load();
+  config.github_activity_enabled = enabled;
+  save(config);
+}
+
+// GitHub Activity privacy level
+// Levels: "full" | "status_only" | "off"
+// - full: Show repos, commit counts, tech stack (default when enabled)
+// - status_only: Just show shipping badge (🔥/⚡), no details
+// - off: Disabled completely
+function getGithubActivityPrivacy() {
+  const config = load();
+  return config.github_activity_privacy || 'full';
+}
+
+function setGithubActivityPrivacy(level) {
+  const validLevels = ['full', 'status_only', 'off'];
+  if (!validLevels.includes(level)) {
+    throw new Error(`Invalid privacy level. Use: ${validLevels.join(', ')}`);
+  }
+  const config = load();
+  config.github_activity_privacy = level;
+  save(config);
+}
+
+// API URL — central endpoint for all API calls
+function getApiUrl() {
+  return process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+}
+
+// ─────────────────────────────────────────────────────────────
+// Generic key-value store for ephemeral session state
+// Used by presence-agent, mute, and other tools for runtime state
+// NOT persisted to disk — resets when MCP server restarts
+// ─────────────────────────────────────────────────────────────
+const sessionState = {};
+
+function get(key, defaultValue = null) {
+  return sessionState[key] !== undefined ? sessionState[key] : defaultValue;
+}
+
+function set(key, value) {
+  sessionState[key] = value;
+  return value;
+}
+
 module.exports = {
   VIBE_DIR,
   CONFIG_FILE,
@@ -248,5 +400,21 @@ module.exports = {
   clearSession,
   generateSessionId,
   getGuidedMode,
-  setGuidedMode
+  setGuidedMode,
+  getNotifications,
+  setNotifications,
+  // GitHub Activity settings
+  getGithubActivityEnabled,
+  setGithubActivityEnabled,
+  getGithubActivityPrivacy,
+  setGithubActivityPrivacy,
+  getApiUrl,
+  // Privy OAuth helpers
+  savePrivyToken,
+  hasPrivyAuth,
+  removeKeypair,
+  getAuthUrl,
+  // Generic key-value for ephemeral session state
+  get,
+  set
 };

package/index.js

@@ -10,9 +10,10 @@ const presence = require('./presence');
 const config = require('./config');
 const store = require('./store');
 const prompts = require('./prompts');
+const NotificationEmitter = require('./notification-emitter');
 
 // Tools that shouldn't show presence footer (would be redundant/noisy)
-const SKIP_FOOTER_TOOLS = ['vibe_init', 'vibe_doctor', 'vibe_test', 'vibe_update'];
+const SKIP_FOOTER_TOOLS = ['vibe_init', 'vibe_doctor', 'vibe_test', 'vibe_update', 'vibe_settings', 'vibe_notifications'];
 
 // Infer user prompt from tool arguments (for pattern logging)
 function inferPromptFromArgs(toolName, args) {
@@ -39,10 +40,29 @@ function inferPromptFromArgs(toolName, args) {
     case 'recall': return `recall ${handle}`;
     case 'forget': return `forget ${handle}`;
     case 'board': return args.content ? 'post to board' : 'view board';
+    case 'observe': return args.content ? 'record observation' : 'view observations';
     case 'invite': return 'generate invite';
     case 'echo': return 'send feedback';
     case 'x_mentions': return 'check x mentions';
     case 'x_reply': return 'reply on x';
+    case 'handoff': return `handoff task to ${handle}`;
+    case 'reserve': return args.paths ? `reserve ${args.paths.join(', ')}` : 'reserve files';
+    case 'release': return `release ${args.reservation_id || 'reservation'}`;
+    case 'reservations': return 'list reservations';
+    case 'solo_game': return `play ${args.game || 'game'}`;
+    case 'tictactoe': return `play tic-tac-toe ${args.difficulty || ''}`.trim();
+    case 'wordassociation': return args.word ? `word association: ${args.word}` : 'play word association';
+    case 'multiplayer_game': return `multiplayer ${args.game || 'game'}`;
+    case 'drawing': return args.action ? `drawing ${args.action}` : 'collaborative drawing';
+    case 'crossword': return `crossword ${args.action || 'daily'}`;
+    case 'away': return args.message ? `set away: "${args.message}"` : 'go away';
+    case 'back': return 'come back';
+    case 'discover': return `discover ${args.command || 'suggest'}`;
+    case 'suggest_tags': return `suggest tags ${args.command || 'suggest'}`;
+    case 'skills_exchange': return `skills exchange ${args.command || 'browse'}`;
+    case 'workshop_buddy': return `workshop buddy ${args.command || 'find'}`;
+    case 'create_artifact': return `create ${args.template || 'artifact'}: ${args.title || 'untitled'}`;
+    case 'view_artifact': return args.slug ? `view artifact ${args.slug}` : `list ${args.list || 'artifacts'}`;
     default: return `${action} ${handle}`.trim() || null;
   }
 }
@@ -150,6 +170,8 @@ const tools = {
   vibe_start: require('./tools/start'),
   // Core
   vibe_init: require('./tools/init'),
+  vibe_token: require('./tools/token'),  // Privy OAuth token setter
+  vibe_migrate: require('./tools/migrate'),  // Migrate existing handle to GitHub auth
   vibe_who: require('./tools/who'),
   vibe_ping: require('./tools/ping'),
   vibe_react: require('./tools/react'),
@@ -161,16 +183,53 @@ const tools = {
   vibe_summarize: require('./tools/summarize'),
   vibe_bye: require('./tools/bye'),
   vibe_game: require('./tools/game'),
+  vibe_solo_game: require('./tools/solo-game'),
+  vibe_party_game: require('./tools/party-game'),
+  vibe_tictactoe: require('./tools/tictactoe'),
+  vibe_wordassociation: require('./tools/wordassociation'),
+  vibe_multiplayer_game: require('./tools/multiplayer-game'),
+  vibe_drawing: require('./tools/drawing'),
+  // Nostalgia Stack
+  vibe_crossword: require('./tools/crossword'),
+  vibe_away: require('./tools/away'),
+  vibe_back: require('./tools/back'),
+  // AIRC Handoff (v1) — context portability
+  vibe_handoff: require('./tools/handoff'),
+  // File reservations (advisory locks)
+  vibe_reserve: require('./tools/reserve'),
+  vibe_release: require('./tools/release'),
+  vibe_reservations: require('./tools/reservations'),
   // Memory tools (Tier 1 — Collaborative Memory)
   vibe_remember: require('./tools/remember'),
   vibe_recall: require('./tools/recall'),
   vibe_forget: require('./tools/forget'),
   // Consent (AIRC compliance)
   vibe_consent: require('./tools/consent'),
+  // Trust & Safety
+  vibe_report: require('./tools/report'),
+  // Support
+  vibe_help: require('./tools/help'),
+  vibe_agents: require('./tools/agents'),
   // Community
   vibe_invite: require('./tools/invite'),
-  vibe_board: require('./tools/board'),
   vibe_submit: require('./tools/submit'),
+  vibe_observe: require('./tools/observe'),
+  // Creative Layer — Ideas, Requests, Ships
+  vibe_idea: require('./tools/idea'),
+  vibe_request: require('./tools/request'),
+  vibe_ship: require('./tools/ship'),
+  vibe_feed: require('./tools/feed'),
+  vibe_insights: require('./tools/insights'),
+  // Artifacts — Just-in-time social objects
+  vibe_create_artifact: require('./tools/artifact-create'),
+  vibe_view_artifact: require('./tools/artifact-view'),
+  // Discovery & Matchmaking
+  vibe_discover: require('./tools/discover'),
+  vibe_suggest_tags: require('./tools/suggest-tags'),
+  vibe_skills_exchange: require('./tools/skills-exchange'),
+  vibe_workshop_buddy: require('./tools/workshop-buddy'),
+  // Admin tools
+  vibe_admin_inbox: require('./tools/admin-inbox'),
   // Diagnostics
   vibe_test: require('./tools/test'),
   vibe_doctor: require('./tools/doctor'),
@@ -184,7 +243,21 @@ const tools = {
   vibe_social_inbox: require('./tools/social-inbox'),
   vibe_social_post: require('./tools/social-post'),
   // Language evolution
-  vibe_patterns: require('./tools/patterns')
+  vibe_patterns: require('./tools/patterns'),
+  // Settings
+  vibe_settings: require('./tools/settings'),
+  // External notification channels
+  vibe_notifications: require('./tools/notifications'),
+  // Background presence agent (Claude Code 2.1)
+  vibe_presence_agent: require('./tools/presence-agent'),
+  vibe_mute: require('./tools/mute'),
+  // Onboarding checklist
+  vibe_onboarding: require('./tools/onboarding'),
+  // VIBE L2 tools
+  vibe_l2: require('./tools/l2'),
+  vibe_l2_status: require('./tools/l2-status'),
+  vibe_shipback: require('./tools/shipback'),
+  vibe_bridge: require('./tools/l2-bridge')
 };
 
 /**
@@ -192,10 +265,30 @@ const tools = {
  */
 class VibeMCPServer {
   constructor() {
+    // Initialize notification emitter
+    this.notifier = new NotificationEmitter(this);
+
+    // Make notifier globally accessible for tools and store layer
+    global.vibeNotifier = this.notifier;
+
     // Start presence heartbeat
     presence.start();
   }
 
+  /**
+   * Send MCP notification
+   * Called by NotificationEmitter to push list_changed events
+   */
+  notification(payload) {
+    // Send notification via stdout (MCP protocol)
+    const notification = {
+      jsonrpc: '2.0',
+      method: payload.method,
+      params: payload.params || {}
+    };
+    process.stdout.write(JSON.stringify(notification) + '\n');
+  }
+
   async handleRequest(request) {
     const { method, params, id } = request;
 
@@ -249,25 +342,38 @@ class VibeMCPServer {
 
           const result = await tool.handler(args);
 
+          // Emit list_changed notification for state-changing tools
+          // This triggers Claude to refresh without reconnection
+          const stateChangingTools = [
+            'vibe_dm', 'vibe_ping', 'vibe_react', 'vibe_remember',
+            'vibe_status', 'vibe_context', 'vibe_handoff',
+            'vibe_reserve', 'vibe_release'
+          ];
+          if (stateChangingTools.includes(params.name)) {
+            // Debounced notification (prevents spam)
+            global.vibeNotifier?.emitChange(params.name);
+          }
+
           // Add ambient presence footer (unless tool is in skip list)
           let footer = '';
           if (!SKIP_FOOTER_TOOLS.includes(params.name)) {
             footer = await getPresenceFooter();
           }
 
-          // Build hint indicator for Claude to trigger dashboard flows
+          // Build simplified hint indicator for Claude (human-readable)
           let hintIndicator = '';
-          if (result.hint || result.actions) {
-            const hintData = {
-              ...(result.hint && { hint: result.hint }),
-              ...(result.suggestion && { suggestion: result.suggestion }),
-              ...(result.unread_count && { unread_count: result.unread_count }),
-              ...(result.for_handle && { for_handle: result.for_handle }),
-              ...(result.memories && { memories: result.memories }),
-              ...(result.threads && { threads: result.threads }),
-              ...(result.actions && { actions: result.actions })
-            };
-            hintIndicator = `\n\n<!-- vibe:dashboard ${JSON.stringify(hintData)} -->`;
+          if (result.hint) {
+            // Simple format: <!-- vibe: hint_type @handle (count) -->
+            const hint = result.hint;
+            const handle = result.suggestion?.handle || result.for_handle || '';
+            const count = result.unread_count || '';
+
+            // Build minimal hint string
+            let hintParts = [hint];
+            if (handle) hintParts.push(`@${handle.replace('@', '')}`);
+            if (count) hintParts.push(`(${count})`);
+
+            hintIndicator = `\n\n<!-- vibe: ${hintParts.join(' ')} -->`;
           }
 
           return {
@@ -330,9 +436,26 @@ class VibeMCPServer {
     process.stderr.write('vibe init → set identity\n');
     process.stderr.write('vibe who  → see who\'s around\n');
     process.stderr.write('vibe dm   → send a message\n\n');
+
+    // Check for updates (non-blocking)
+    this.checkForUpdates();
+  }
+
+  async checkForUpdates() {
+    try {
+      const { checkForUpdates, formatUpdateNotification } = await import('./auto-update.js');
+      const update = await checkForUpdates();
+
+      if (update) {
+        const notification = formatUpdateNotification(update);
+        process.stderr.write(notification);
+      }
+    } catch (error) {
+      // Silent fail - don't block startup
+    }
   }
 }
 
 // Start
 const server = new VibeMCPServer();
-server.start();
+server.start();

package/intelligence/index.js

@@ -0,0 +1,38 @@
+/**
+ * Intelligence Module — Ambient Social Awareness
+ *
+ * Four layers of intelligence:
+ * 1. Infer — Smart state detection from context signals
+ * 2. Serendipity — Surface meaningful coincidences
+ * 3. Proactive — Background agent for social moments
+ * 4. Patterns — Persistent behavioral memory (work, social, creative)
+ */
+
+const infer = require('./infer');
+const serendipity = require('./serendipity');
+const proactive = require('./proactive');
+const patterns = require('./patterns');
+
+module.exports = {
+  // Inference
+  inferState: infer.inferState,
+  enhanceUserWithInference: infer.enhanceUserWithInference,
+  enhanceUsersWithInference: infer.enhanceUsersWithInference,
+  STATES: infer.STATES,
+
+  // Serendipity
+  findSerendipity: serendipity.findSerendipity,
+  getTopSerendipity: serendipity.getTopSerendipity,
+  getAllSerendipity: serendipity.getAllSerendipity,
+
+  // Proactive
+  generateProactiveSuggestions: proactive.generateProactiveSuggestions,
+  getProactiveSummary: proactive.getProactiveSummary,
+  checkProactiveOpportunities: proactive.checkProactiveOpportunities,
+  markAway: proactive.markAway,
+  markBack: proactive.markBack,
+  setSessionStart: proactive.setSessionStart,
+
+  // Patterns (persistent behavioral memory)
+  patterns
+};