slashvibe-mcp 0.3.20 → 0.3.22

package/README.md

@@ -1,5 +1,10 @@
 # /vibe MCP Server
 
+[![npm version](https://img.shields.io/npm/v/slashvibe-mcp.svg)](https://www.npmjs.com/package/slashvibe-mcp)
+[![license](https://img.shields.io/npm/l/slashvibe-mcp.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/slashvibe-mcp.svg)](https://nodejs.org)
+[![CI](https://github.com/VibeCodingInc/vibe-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/VibeCodingInc/vibe-mcp/actions/workflows/ci.yml)
+
 The social layer for AI coding. DMs, presence, discovery, and games between developers — without leaving your editor.
 
 Works with Claude Code, Cursor, VS Code, Windsurf, Cline, Continue.dev, JetBrains, and any MCP-compatible client.
@@ -146,83 +151,106 @@ If you prefer step-by-step:
 3. **Check messages** — `vibe inbox` shows unread DMs.
 4. **Send your first message** — `vibe dm @seth hey, just set up /vibe!`
 
-## Tools
+## Tools (39)
 
-### Core — Messaging & Presence
+### Core — Identity & Session
 
 | Tool | What it does |
 |------|-------------|
 | `vibe_start` | Entry point — authenticates, shows who's online, checks inbox |
 | `vibe_init` | Set up your identity via GitHub OAuth |
-| `vibe_who` | See who's online and what they're building |
+| `vibe_bye` | End your session |
+
+### Core — Messaging
+
+| Tool | What it does |
+|------|-------------|
 | `vibe_dm` | Send a direct message |
 | `vibe_inbox` | Check your unread messages |
-| `vibe_open` | Open a conversation thread with someone |
 | `vibe_ping` | Send a quick wave to someone |
 | `vibe_react` | React to a message |
-| `vibe_status` | Set your mood or what you're working on |
-| `vibe_away` / `vibe_back` | Set yourself away or return |
-| `vibe_bye` | End your session |
+| `vibe_open` | Open a conversation thread with someone |
 
-### Discovery — Find Your People
+### Presence
 
 | Tool | What it does |
 |------|-------------|
-| `vibe_discover` | Find builders by interests, projects, or activity |
-| `vibe_suggest_tags` | Get tag suggestions for your profile |
-| `vibe_skills_exchange` | Browse and offer skills |
-| `vibe_workshop_buddy` | Find a learning partner |
-| `vibe_invite` | Generate an invite link |
+| `vibe_who` | See who's online and what they're building |
+| `vibe_status` | Set your mood or what you're working on |
+| `vibe_away` | Set yourself away |
+| `vibe_back` | Return from away |
 
 ### Creative — Ship & Share
 
 | Tool | What it does |
 |------|-------------|
-| `vibe_ship` | Announce what you shipped |
-| `vibe_idea` | Share an idea with the community |
-| `vibe_request` | Ask the community for help |
+| `vibe_ship` | Share with the community: ship (default), idea, or request via `type` param |
+| `vibe_session_save` | Save your coding session — makes it replayable, discoverable, and forkable |
+| `vibe_session_fork` | Fork an existing session to build on it |
 | `vibe_feed` | See what people are shipping and sharing |
-| `vibe_create_artifact` | Create a shareable guide, workspace, or learning |
-| `vibe_view_artifact` | View shared artifacts |
+| `vibe_context` | Share what you're working on |
 
-### Memory — Context That Persists
+### Discovery
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_discover` | Find people, skills, and partners. Subcommands: suggest, search, interests, active, skills, partner |
+| `vibe_invite` | Generate an invite link |
+
+### Memory
 
 | Tool | What it does |
 |------|-------------|
 | `vibe_remember` | Save a note about someone for next time |
 | `vibe_recall` | Pull up everything you know about someone |
 | `vibe_forget` | Delete a memory |
-| `vibe_handoff` | Create an AIRC context handoff for another tool |
 
 ### Games — 27 Multiplayer & Solo Games
 
 | Tool | What it does |
 |------|-------------|
-| `vibe_game` | Start a multiplayer game with someone |
-| `vibe_solo_game` | Play a solo game (riddles, hangman, number guess) |
-| `vibe_tictactoe` | Challenge someone to tic-tac-toe |
-| `vibe_crossword` | Collaborative crossword puzzle |
-| `vibe_drawing` | Collaborative ASCII drawing |
-| `vibe_party_game` | Start a party game for 3+ players |
+| `vibe_game` | All games via one tool. Multiplayer (tictactoe, chess), solo (hangman, rps, memory), party (twotruths, werewolf), AI (tictactoe-ai), collaborative (drawing, crossword, wordassociation, wordchain, storybuilder) |
+
+### Artifacts
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_create_artifact` | Create a shareable guide, workspace, or learning |
+| `vibe_view_artifact` | View shared artifacts |
+
+### File Coordination
+
+| Tool | What it does |
+|------|-------------|
+| `vibe_reserve` | Reserve files for editing |
+| `vibe_release` | Release file reservations |
+| `vibe_reservations` | List active file reservations |
 
-### Bridges — Cross-Platform Social
+### Infrastructure
 
 | Tool | What it does |
 |------|-------------|
-| `vibe_x_mentions` | Check your X/Twitter mentions |
-| `vibe_x_reply` | Reply on X from the terminal |
-| `vibe_social_inbox` | Unified inbox across platforms |
-| `vibe_social_post` | Post to multiple networks at once |
+| `vibe_handoff` | Create an AIRC context handoff for another tool |
+| `vibe_report` | Report issues or inappropriate behavior |
+| `vibe_suggest_tags` | Get tag suggestions for your profile |
 
 ### Diagnostics
 
 | Tool | What it does |
 |------|-------------|
-| `vibe_doctor` | Full health check — API, auth, storage, presence |
-| `vibe_test` | Quick connection and identity test |
 | `vibe_help` | Show available commands |
+| `vibe_doctor` | Full health check — API, auth, storage, presence |
 | `vibe_update` | Check for and apply updates |
+
+### Settings
+
+| Tool | What it does |
+|------|-------------|
 | `vibe_settings` | Configure preferences |
+| `vibe_notifications` | Configure notification channels |
+| `vibe_presence_agent` | Background presence agent |
+| `vibe_mute` | Mute a user |
+| `vibe_summarize` | Summarize session context |
 
 ## How It Works
 

package/config.js

@@ -10,8 +10,8 @@ const path = require('path');
 
 const VIBE_DIR = path.join(process.env.HOME, '.vibe');
 const VIBECODINGS_DIR = path.join(process.env.HOME, '.vibecodings');
-const PRIMARY_CONFIG = path.join(VIBECODINGS_DIR, 'config.json');  // Primary
-const FALLBACK_CONFIG = path.join(VIBE_DIR, 'config.json');        // Fallback
+const PRIMARY_CONFIG = path.join(VIBECODINGS_DIR, 'config.json'); // Primary
+const FALLBACK_CONFIG = path.join(VIBE_DIR, 'config.json'); // Fallback
 const CONFIG_FILE = PRIMARY_CONFIG;
 
 function ensureDir() {
@@ -70,7 +70,8 @@ function save(config) {
     // 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_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,
@@ -79,6 +80,7 @@ function save(config) {
   fs.writeFileSync(PRIMARY_CONFIG, JSON.stringify(data, null, 2));
 }
 
+/** @returns {string|null} Current user handle */
 function getHandle() {
   // Prefer session-specific handle over shared config
   const sessionHandle = getSessionHandle();
@@ -88,6 +90,7 @@ function getHandle() {
   return config.handle || null;
 }
 
+/** @returns {string|null} Current user one-liner */
 function getOneLiner() {
   // Prefer session-specific one_liner over shared config
   const sessionOneLiner = getSessionOneLiner();
@@ -97,6 +100,7 @@ function getOneLiner() {
   return config.one_liner || null;
 }
 
+/** @returns {boolean} Whether user identity is set */
 function isInitialized() {
   // Check session first, then shared config
   const sessionHandle = getSessionHandle();
@@ -109,6 +113,7 @@ function isInitialized() {
 // Now stores full identity (handle + one_liner), not just sessionId
 const SESSION_FILE = path.join(VIBECODINGS_DIR, `.session_${process.pid}`);
 
+/** @returns {string} New session ID (sess_*) */
 function generateSessionId() {
   return 'sess_' + Date.now().toString(36) + Math.random().toString(36).substring(2, 10);
 }
@@ -231,7 +236,7 @@ function savePrivyToken(token) {
     ...data,
     sessionId: data.sessionId || generateSessionId(),
     token,
-    authMethod: 'privy'  // Track that this is a Privy token
+    authMethod: 'privy' // Track that this is a Privy token
   });
 
   // Also save to shared config for persistence across MCP restarts
@@ -359,7 +364,7 @@ function setGithubActivityPrivacy(level) {
   save(config);
 }
 
-// API URL — central endpoint for all API calls
+/** @returns {string} API base URL */
 function getApiUrl() {
   return process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
 }
@@ -371,10 +376,22 @@ function getApiUrl() {
 // ─────────────────────────────────────────────────────────────
 const sessionState = {};
 
+/**
+ * Get ephemeral session state value
+ * @param {string} key - State key
+ * @param {*} [defaultValue=null] - Default if not set
+ * @returns {*} Stored value or default
+ */
 function get(key, defaultValue = null) {
   return sessionState[key] !== undefined ? sessionState[key] : defaultValue;
 }
 
+/**
+ * Set ephemeral session state value
+ * @param {string} key - State key
+ * @param {*} value - Value to store
+ * @returns {*} The stored value
+ */
 function set(key, value) {
   sessionState[key] = value;
   return value;

package/crypto.js

@@ -106,12 +106,7 @@ function verify(obj, publicKeyBase64) {
     });
 
     // Verify
-    return crypto.verify(
-      null,
-      Buffer.from(canonical, 'utf8'),
-      publicKey,
-      Buffer.from(signature, 'base64')
-    );
+    return crypto.verify(null, Buffer.from(canonical, 'utf8'), publicKey, Buffer.from(signature, 'base64'));
   } catch (e) {
     console.error('[crypto] Verification failed:', e.message);
     return false;

package/discord.js

@@ -60,7 +60,7 @@ async function post(content, options = {}) {
  */
 async function postJoin(handle, oneLiner) {
   const embed = {
-    color: 0x6B8FFF, // Spirit blue
+    color: 0x6b8fff, // Spirit blue
     title: `@${handle} joined /vibe`,
     description: oneLiner || 'Building something',
     footer: { text: 'slashvibe.dev' },
@@ -74,7 +74,7 @@ async function postJoin(handle, oneLiner) {
  */
 async function postActivity(handle, action) {
   const embed = {
-    color: 0x2ECC71, // Green
+    color: 0x2ecc71, // Green
     description: `**@${handle}** ${action}`,
     timestamp: new Date().toISOString()
   };
@@ -86,17 +86,17 @@ async function postActivity(handle, action) {
  */
 async function postStatus(handle, mood, note) {
   const moodEmoji = {
-    'shipping': '🔥',
-    'debugging': '🐛',
-    'deep': '🧠',
-    'afk': '☕',
-    'celebrating': '🎉',
-    'pairing': '👯'
+    shipping: '🔥',
+    debugging: '🐛',
+    deep: '🧠',
+    afk: '☕',
+    celebrating: '🎉',
+    pairing: '👯'
   };
 
   const emoji = moodEmoji[mood] || '●';
   const embed = {
-    color: 0x9B59B6, // Purple
+    color: 0x9b59b6, // Purple
     description: `${emoji} **@${handle}** is ${mood}${note ? `: "${note}"` : ''}`,
     timestamp: new Date().toISOString()
   };
@@ -108,7 +108,7 @@ async function postStatus(handle, mood, note) {
  */
 async function postAnnouncement(message) {
   const embed = {
-    color: 0x6B8FFF,
+    color: 0x6b8fff,
     title: '/vibe',
     description: message,
     timestamp: new Date().toISOString()
@@ -120,12 +120,10 @@ async function postAnnouncement(message) {
  * Post a conversation highlight
  */
 async function postHighlight(handle, title, summary, threads = []) {
-  const threadList = threads.length > 0
-    ? '\n\n**Open threads:**\n' + threads.map(t => `• ${t}`).join('\n')
-    : '';
+  const threadList = threads.length > 0 ? '\n\n**Open threads:**\n' + threads.map(t => `• ${t}`).join('\n') : '';
 
   const embed = {
-    color: 0xF39C12, // Gold/amber for highlights
+    color: 0xf39c12, // Gold/amber for highlights
     title: `💬 ${title}`,
     description: summary + threadList,
     footer: { text: `shared by @${handle} · slashvibe.dev` },
@@ -142,13 +140,15 @@ async function postOnlineList(users) {
     return post('_Room is quiet..._');
   }
 
-  const list = users.map(u => {
-    const mood = u.mood ? ` ${u.mood}` : '';
-    return `• **@${u.handle}**${mood} — ${u.one_liner || 'building'}`;
-  }).join('\n');
+  const list = users
+    .map(u => {
+      const mood = u.mood ? ` ${u.mood}` : '';
+      return `• **@${u.handle}**${mood} — ${u.one_liner || 'building'}`;
+    })
+    .join('\n');
 
   const embed = {
-    color: 0x6B8FFF,
+    color: 0x6b8fff,
     title: `${users.length} online in /vibe`,
     description: list,
     footer: { text: 'slashvibe.dev' },