slashvibe-mcp 0.3.21 → 0.3.23

package/post-install.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for slashvibe-mcp
+ * Sets up MCP server configuration and CLAUDE.md for Claude Code
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const HOME = homedir();
+const CLAUDE_CONFIG_DIR = path.join(HOME, '.config', 'claude-code');
+const MCP_CONFIG_PATH = path.join(CLAUDE_CONFIG_DIR, 'mcp.json');
+const CLAUDE_MD_DIR = path.join(HOME, '.claude');
+const CLAUDE_MD_PATH = path.join(CLAUDE_MD_DIR, 'CLAUDE.md');
+const VIBE_MARKER = '## /vibe - Terminal-Native Social';
+
+async function setup() {
+  console.log('\n📦 Setting up /vibe...\n');
+
+  try {
+    // Ensure config directory exists
+    await fs.mkdir(CLAUDE_CONFIG_DIR, { recursive: true });
+    await fs.mkdir(CLAUDE_MD_DIR, { recursive: true });
+
+    // Read existing MCP config or create new
+    let config = { mcpServers: {} };
+    try {
+      const existing = await fs.readFile(MCP_CONFIG_PATH, 'utf-8');
+      config = JSON.parse(existing);
+      if (!config.mcpServers) config.mcpServers = {};
+    } catch (error) {
+      // File doesn't exist, use default
+    }
+
+    // Use npx to run slashvibe-mcp — works regardless of install location
+    config.mcpServers.vibe = {
+      command: 'npx',
+      args: ['-y', 'slashvibe-mcp']
+    };
+
+    // Write config
+    await fs.writeFile(MCP_CONFIG_PATH, JSON.stringify(config, null, 2));
+
+    // Inject CLAUDE.md template for dashboard mode
+    await injectClaudeMd();
+
+    console.log('✅ /vibe MCP server configured\n');
+    console.log('Next steps:');
+    console.log('  1. Restart Claude Code');
+    console.log('  2. Run: vibe init @yourusername\n');
+    console.log('📖 Docs: https://slashvibe.dev\n');
+  } catch (error) {
+    console.error('⚠️  Setup incomplete:', error.message);
+    console.error('\nManual setup:');
+    console.error('  Add to ~/.config/claude-code/mcp.json:\n');
+    console.error('  {');
+    console.error('    "mcpServers": {');
+    console.error('      "vibe": {');
+    console.error('        "command": "npx",');
+    console.error('        "args": ["-y", "slashvibe-mcp"]');
+    console.error('      }');
+    console.error('    }');
+    console.error('  }\n');
+  }
+}
+
+/**
+ * Inject /vibe CLAUDE.md template for dashboard mode and hint handling
+ * - If CLAUDE.md doesn't exist, create it with template
+ * - If exists but no /vibe section, append template
+ * - If /vibe section exists, update it with latest template
+ */
+async function injectClaudeMd() {
+  try {
+    // Find the template relative to this script
+    // When installed via npm: ../dashboard/VIBE_CLAUDE_MD_TEMPLATE.md
+    const templatePath = path.join(__dirname, '..', 'dashboard', 'VIBE_CLAUDE_MD_TEMPLATE.md');
+
+    let template;
+    try {
+      template = await fs.readFile(templatePath, 'utf-8');
+    } catch (e) {
+      // Template not found (might be dev environment), skip injection
+      console.log('ℹ️  CLAUDE.md template not found, skipping dashboard setup');
+      return;
+    }
+
+    // Check if CLAUDE.md exists
+    let existingContent = '';
+    try {
+      existingContent = await fs.readFile(CLAUDE_MD_PATH, 'utf-8');
+    } catch (e) {
+      // File doesn't exist, will create new
+    }
+
+    if (existingContent.includes(VIBE_MARKER)) {
+      // /vibe section exists - replace it with updated template
+      // Find the section and replace it
+      const startIndex = existingContent.indexOf(VIBE_MARKER);
+
+      // Find the next ## header (or end of file)
+      const afterMarker = existingContent.substring(startIndex + VIBE_MARKER.length);
+      const nextSectionMatch = afterMarker.match(/\n## (?!\/vibe)/);
+
+      let endIndex;
+      if (nextSectionMatch) {
+        endIndex = startIndex + VIBE_MARKER.length + nextSectionMatch.index;
+      } else {
+        endIndex = existingContent.length;
+      }
+
+      // Replace the section
+      const beforeSection = existingContent.substring(0, startIndex);
+      const afterSection = existingContent.substring(endIndex);
+      const newContent = beforeSection + template + afterSection;
+
+      await fs.writeFile(CLAUDE_MD_PATH, newContent);
+      console.log('✅ CLAUDE.md updated with latest /vibe dashboard');
+    } else if (existingContent) {
+      // CLAUDE.md exists but no /vibe section - append
+      const newContent = existingContent + '\n\n' + template;
+      await fs.writeFile(CLAUDE_MD_PATH, newContent);
+      console.log('✅ /vibe dashboard added to CLAUDE.md');
+    } else {
+      // No CLAUDE.md - create with template
+      await fs.writeFile(CLAUDE_MD_PATH, template);
+      console.log('✅ CLAUDE.md created with /vibe dashboard');
+    }
+  } catch (error) {
+    // Non-fatal - log but don't fail installation
+    console.log('ℹ️  Could not update CLAUDE.md:', error.message);
+  }
+}
+
+setup();

package/presence.js

@@ -60,7 +60,7 @@ async function sendHeartbeat() {
   const handle = config.getHandle();
   const one_liner = config.getOneLiner();
   if (handle) {
-    store.heartbeat(handle, one_liner || '');
+    store.heartbeat(handle, one_liner || '', null, 'mcp');
 
     // Check for notifications (runs in background, non-blocking)
     notify.checkAll(store).catch(() => {});
@@ -84,7 +84,7 @@ async function forceHeartbeat() {
 
   // Send heartbeat
   const one_liner = config.getOneLiner();
-  await store.heartbeat(handle, one_liner || '');
+  await store.heartbeat(handle, one_liner || '', null, 'mcp');
 
   return { success: true, handle };
 }

package/prompts.js

@@ -25,7 +25,7 @@ function log(prompt, resolution) {
     tool: resolution.tool || null,
     action: resolution.action || null,
     target: resolution.target || null, // @handle, channel, etc.
-    transform: resolution.transform || null, // emoji, recap, etc.
+    transform: resolution.transform || null // emoji, recap, etc.
   };
 
   try {
@@ -44,10 +44,7 @@ function getRecent(limit = 50) {
   try {
     if (!fs.existsSync(PROMPTS_FILE)) return [];
 
-    const lines = fs.readFileSync(PROMPTS_FILE, 'utf8')
-      .trim()
-      .split('\n')
-      .filter(Boolean);
+    const lines = fs.readFileSync(PROMPTS_FILE, 'utf8').trim().split('\n').filter(Boolean);
 
     return lines
       .slice(-limit)
@@ -68,7 +65,8 @@ function extractPatterns() {
 
   for (const p of prompts) {
     // Normalize: lowercase, replace @handles with @*, replace quoted strings with "*"
-    const normalized = p.prompt.toLowerCase()
+    const normalized = p.prompt
+      .toLowerCase()
       .replace(/@\w+/g, '@*')
       .replace(/"[^"]+"/g, '"*"')
       .replace(/'[^']+'/g, "'*'")
@@ -125,9 +123,7 @@ function getAnonymizedPatterns() {
     pattern,
     frequency: count,
     // Remove any potentially identifying info
-    normalized: pattern
-      .replace(/\d+/g, 'N')
-      .replace(/[a-f0-9]{8,}/gi, 'HASH')
+    normalized: pattern.replace(/\d+/g, 'N').replace(/[a-f0-9]{8,}/gi, 'HASH')
   }));
 }
 

package/protocol/index.js

@@ -34,7 +34,7 @@ const PROTOCOL_VERSION = '0.1.0';
 const GAME_SCHEMA = {
   type: 'game',
   required: ['game', 'state'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.game || typeof payload.game !== 'string') {
       return { valid: false, error: 'Missing or invalid game name' };
     }
@@ -65,7 +65,7 @@ const GAME_SCHEMA = {
 const HANDOFF_SCHEMA = {
   type: 'handoff',
   required: ['task', 'context'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.task || typeof payload.task !== 'string') {
       return { valid: false, error: 'Missing or invalid task type' };
     }
@@ -90,7 +90,7 @@ const HANDOFF_SCHEMA = {
 const ACK_SCHEMA = {
   type: 'ack',
   required: ['replyTo', 'status'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.replyTo || typeof payload.replyTo !== 'string') {
       return { valid: false, error: 'Missing or invalid replyTo' };
     }
@@ -119,7 +119,7 @@ const ACK_SCHEMA = {
 const ARTIFACT_SCHEMA = {
   type: 'artifact',
   required: ['artifactId', 'slug', 'title', 'template', 'url'],
-  validate: (payload) => {
+  validate: payload => {
     if (!payload.artifactId || typeof payload.artifactId !== 'string') {
       return { valid: false, error: 'Missing or invalid artifactId' };
     }
@@ -139,11 +139,56 @@ const ARTIFACT_SCHEMA = {
   }
 };
 
+/**
+ * Agent wire schema — For agent-to-agent communication on the wire
+ *
+ * Used when external agents (Clawdbot, @seth) communicate via /vibe.
+ * AIRC-signed for identity verification.
+ *
+ * Example:
+ * {
+ *   type: 'agent',
+ *   version: '0.1.0',
+ *   action: 'session_sync',
+ *   idempotencyKey: 'agent_seth_session_abc',
+ *   source: { platform: 'telegram', gateway: 'clawdbot' },
+ *   context: {
+ *     session: 'NODE logistics',
+ *     mood: 'shipping',
+ *     file: 'node365/submit/page.tsx'
+ *   }
+ * }
+ */
+const AGENT_SCHEMA = {
+  type: 'agent',
+  required: ['action'],
+  validate: payload => {
+    if (!payload.action || typeof payload.action !== 'string') {
+      return { valid: false, error: 'Missing or invalid action' };
+    }
+    const validActions = [
+      'session_sync',   // Sync session state to /vibe presence
+      'event_subscribe', // Subscribe to event pushes
+      'memory_query',   // Query local memory
+      'memory_store',   // Store observation
+      'identity_verify', // AIRC identity verification
+      'heartbeat',      // Agent heartbeat
+      'capability_announce' // Announce agent capabilities
+    ];
+    // Allow unknown actions for forward compat
+    if (!validActions.includes(payload.action)) {
+      return { valid: true, unknown_action: true };
+    }
+    return { valid: true };
+  }
+};
+
 const SCHEMAS = {
   game: GAME_SCHEMA,
   handoff: HANDOFF_SCHEMA,
   ack: ACK_SCHEMA,
-  artifact: ARTIFACT_SCHEMA
+  artifact: ARTIFACT_SCHEMA,
+  agent: AGENT_SCHEMA
 };
 
 // ============ PROTOCOL FUNCTIONS ============
@@ -230,10 +275,14 @@ function generateIdempotencyKey(prefix, context = '') {
  * @returns {Object} - Game payload
  */
 function createGamePayload(game, state, options = {}) {
-  return createPayload('game', { game, state }, {
-    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('game', game),
-    ...options
-  });
+  return createPayload(
+    'game',
+    { game, state },
+    {
+      idempotencyKey: options.idempotencyKey || generateIdempotencyKey('game', game),
+      ...options
+    }
+  );
 }
 
 /**
@@ -263,10 +312,14 @@ function createTicTacToePayload(board, turn, moves, winner = null) {
  * @returns {Object} - Handoff payload
  */
 function createHandoffPayload(task, context, options = {}) {
-  return createPayload('handoff', { task, context }, {
-    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('handoff', task),
-    ...options
-  });
+  return createPayload(
+    'handoff',
+    { task, context },
+    {
+      idempotencyKey: options.idempotencyKey || generateIdempotencyKey('handoff', task),
+      ...options
+    }
+  );
 }
 
 // ============ ACK HELPERS ============
@@ -307,8 +360,8 @@ function formatPayload(payload) {
       return formatAckPayload(payload);
     case 'artifact':
       return formatArtifactPayload(payload);
-    case 'code':
-      return formatCodePayload(payload);
+    case 'agent':
+      return formatAgentPayload(payload);
     default:
       return `📦 _${payload.type} payload_`;
   }
@@ -320,7 +373,7 @@ function formatGamePayload(payload) {
 
   if (game === 'tictactoe' && state.board) {
     const b = state.board;
-    const cell = (i) => b[i] || '·';
+    const cell = i => b[i] || '·';
     return `🎮 **Tic-Tac-Toe** (move ${state.moves || '?'})
 \`\`\`
  ${cell(0)} │ ${cell(1)} │ ${cell(2)}
@@ -359,77 +412,10 @@ function formatAckPayload(payload) {
   return `${icon} Acknowledged: ${payload.replyTo} (${status})`;
 }
 
-/**
- * Format a code snippet payload for display
- */
-function formatCodePayload(payload) {
-  const lang = payload.language || '';
-  const filename = payload.filename || null;
-  const code = payload.code || '';
-  const description = payload.description || null;
-
-  let display = '📝 **Code Snippet**';
-  if (filename) {
-    display += ` — \`${filename}\``;
-  }
-  if (lang) {
-    display += ` (${lang})`;
-  }
-  display += '\n';
-
-  if (description) {
-    display += `> ${description}\n`;
-  }
-
-  display += `\`\`\`${lang}\n${code}\n\`\`\``;
-
-  return display;
-}
-
-/**
- * Create a code snippet payload
- * @param {string} code - The code content
- * @param {object} options - Options
- * @param {string} [options.language] - Programming language
- * @param {string} [options.filename] - Original filename
- * @param {string} [options.description] - Brief description
- */
-function createCodePayload(code, options = {}) {
-  return {
-    type: 'code',
-    version: PROTOCOL_VERSION,
-    code,
-    language: options.language || detectLanguage(code),
-    filename: options.filename || null,
-    description: options.description || null,
-  };
-}
-
-/**
- * Simple language detection based on content patterns
- */
-function detectLanguage(code) {
-  if (!code) return '';
-
-  // Check for common patterns
-  if (code.includes('import React') || code.includes('useState') || code.includes('useEffect')) return 'jsx';
-  if (code.includes('import ') && code.includes(' from ')) return 'javascript';
-  if (code.includes('async function') || code.includes('await ')) return 'javascript';
-  if (code.includes('def ') && code.includes(':')) return 'python';
-  if (code.includes('func ') && code.includes('()')) return 'go';
-  if (code.includes('fn ') && code.includes('->')) return 'rust';
-  if (code.includes('SELECT ') || code.includes('INSERT INTO')) return 'sql';
-  if (code.includes('<!DOCTYPE') || code.includes('<html')) return 'html';
-  if (code.includes('{') && code.includes(':') && code.includes(';')) return 'css';
-  if (code.startsWith('{') && code.endsWith('}')) return 'json';
-  if (code.startsWith('#!') && code.includes('/bin/')) return 'bash';
-
-  return '';
-}
-
 function formatArtifactPayload(payload) {
   const template = payload.template || 'artifact';
-  const templateIcon = template === 'guide' ? '📘' : template === 'learning' ? '💡' : template === 'workspace' ? '🗂️' : '📦';
+  const templateIcon =
+    template === 'guide' ? '📘' : template === 'learning' ? '💡' : template === 'workspace' ? '🗂️' : '📦';
 
   let display = `${templateIcon} **${payload.title}**\n`;
 
@@ -470,6 +456,56 @@ function createArtifactPayload(artifact) {
   });
 }
 
+// ============ AGENT HELPERS ============
+
+/**
+ * Create an agent wire payload
+ * @param {string} action - Agent action (session_sync, event_subscribe, etc.)
+ * @param {object} data - Action-specific data
+ * @param {object} [options] - Options (idempotencyKey, source)
+ * @returns {object} - Agent payload
+ */
+function createAgentPayload(action, data = {}, options = {}) {
+  const payload = {
+    action,
+    ...data
+  };
+
+  if (options.source) {
+    payload.source = options.source;
+  }
+
+  return createPayload('agent', payload, {
+    idempotencyKey: options.idempotencyKey || generateIdempotencyKey('agent', action),
+    ...options
+  });
+}
+
+/**
+ * Format agent payload for display
+ */
+function formatAgentPayload(payload) {
+  const action = payload.action || 'unknown';
+  const source = payload.source
+    ? ` (via ${payload.source.platform || payload.source.gateway || 'unknown'})`
+    : '';
+
+  switch (action) {
+    case 'session_sync':
+      return `🤖 **Session sync**${source}\n> ${payload.context?.session || 'active'}`;
+    case 'event_subscribe':
+      return `🔔 **Event subscription**${source}\n> ${(payload.events || []).join(', ')}`;
+    case 'heartbeat':
+      return `💓 **Agent heartbeat**${source}`;
+    case 'identity_verify':
+      return `🔑 **Identity verification**${source}`;
+    case 'capability_announce':
+      return `📡 **Capabilities**${source}\n> ${(payload.capabilities || []).join(', ')}`;
+    default:
+      return `🤖 **Agent: ${action}**${source}`;
+  }
+}
+
 module.exports = {
   PROTOCOL_VERSION,
 
@@ -492,8 +528,8 @@ module.exports = {
   // Artifact helpers
   createArtifactPayload,
 
-  // Code helpers
-  createCodePayload,
+  // Agent helpers
+  createAgentPayload,
 
   // Schemas (for extension)
   SCHEMAS

package/protocol/telegram-commands.js

@@ -1,12 +1,12 @@
 /**
  * /vibe Telegram Command Processor
- * 
+ *
  * Executes /vibe commands received via Telegram bot.
  * Maps Telegram users to /vibe handles and executes core protocol functions.
  */
 
 const { dm } = require('../tools/dm');
-const { status } = require('../tools/status'); 
+const { status } = require('../tools/status');
 const { who } = require('../tools/who');
 const { ship } = require('../tools/ship');
 const config = require('../config');
@@ -17,7 +17,7 @@ const config = require('../config');
 async function processVibeCommand(command, params, telegramUser) {
   // Map Telegram user to /vibe handle
   const vibeHandle = mapTelegramUserToHandle(telegramUser);
-  
+
   if (!vibeHandle) {
     return `❌ Telegram account not linked to /vibe. Contact admin to link @${telegramUser.username || telegramUser.first_name} to a /vibe handle.`;
   }
@@ -26,20 +26,19 @@ async function processVibeCommand(command, params, telegramUser) {
     switch (command) {
       case 'status':
         return await executeStatus(params.mood, params.note, vibeHandle);
-        
+
       case 'who':
         return await executeWho();
-        
+
       case 'ship':
         return await executeShip(params.message, vibeHandle);
-        
+
       case 'dm':
         return await executeDM(params.handle, params.message, vibeHandle);
-        
+
       default:
         return `❌ Unknown command: ${command}`;
     }
-    
   } catch (error) {
     console.error(`Telegram command error [${command}]:`, error);
     return `❌ Command failed: ${error.message}`;
@@ -52,7 +51,7 @@ async function processVibeCommand(command, params, telegramUser) {
 function mapTelegramUserToHandle(telegramUser) {
   const cfg = config.load();
   const telegramMappings = cfg.telegram_user_mappings || {};
-  
+
   // Try username first, then user ID
   const telegramKey = telegramUser.username || telegramUser.id.toString();
   return telegramMappings[telegramKey] || null;
@@ -65,19 +64,19 @@ async function executeStatus(mood, note, handle) {
   if (!mood) {
     return '❌ Need a mood. Try: `/status shipping "building the future"`';
   }
-  
+
   const validMoods = ['shipping', 'debugging', 'deep', 'afk', 'celebrating', 'pairing'];
   if (!validMoods.includes(mood)) {
     return `❌ Invalid mood. Use: ${validMoods.join(', ')}`;
   }
-  
+
   // Execute the status update
   const result = await status.handler({ mood, note });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `✅ Status updated: **${handle}** is ${mood}${note ? ` - "${note}"` : ''}`;
 }
 
@@ -86,33 +85,33 @@ async function executeStatus(mood, note, handle) {
  */
 async function executeWho() {
   const result = await who.handler({});
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   // Convert display format to Telegram-friendly
   let response = result.display;
-  
+
   // Replace markdown formatting for Telegram
   response = response
     .replace(/\*\*(.*?)\*\*/g, '*$1*') // Bold
-    .replace(/_(.*?)_/g, '_$1_')       // Italic
-    .replace(/`(.*?)`/g, '`$1`');       // Code
-    
+    .replace(/_(.*?)_/g, '_$1_') // Italic
+    .replace(/`(.*?)`/g, '`$1`'); // Code
+
   return response;
 }
 
 /**
- * Execute ship command  
+ * Execute ship command
  */
 async function executeShip(message, handle) {
   const result = await ship.handler({ what: message });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `🚀 Shipped! ${message ? `"${message}"` : 'Great work!'} has been announced to /vibe.`;
 }
 
@@ -123,23 +122,23 @@ async function executeDM(targetHandle, message, fromHandle) {
   if (!targetHandle) {
     return '❌ Need target handle. Try: `/dm @alice "hey there!"`';
   }
-  
+
   if (!message) {
     return '❌ Need message content.';
   }
-  
+
   // Remove @ if present
   const cleanHandle = targetHandle.replace('@', '');
-  
-  const result = await dm.handler({ 
-    to: cleanHandle, 
-    message: message 
+
+  const result = await dm.handler({
+    to: cleanHandle,
+    message: message
   });
-  
+
   if (result.error) {
     return `❌ ${result.error}`;
   }
-  
+
   return `📨 DM sent to @${cleanHandle}: "${message}"`;
 }
 
@@ -148,19 +147,19 @@ async function executeDM(targetHandle, message, fromHandle) {
  */
 async function linkTelegramUser(telegramUser, vibeHandle) {
   const cfg = config.load();
-  
+
   if (!cfg.telegram_user_mappings) {
     cfg.telegram_user_mappings = {};
   }
-  
+
   // Store both username and ID for flexibility
   if (telegramUser.username) {
     cfg.telegram_user_mappings[telegramUser.username] = vibeHandle;
   }
   cfg.telegram_user_mappings[telegramUser.id.toString()] = vibeHandle;
-  
+
   config.save(cfg);
-  
+
   return {
     success: true,
     message: `Linked Telegram user ${telegramUser.username || telegramUser.id} to /vibe handle @${vibeHandle}`
@@ -180,13 +179,13 @@ function getTelegramMappings() {
  */
 function unlinkTelegramUser(telegramKey) {
   const cfg = config.load();
-  
+
   if (cfg.telegram_user_mappings && cfg.telegram_user_mappings[telegramKey]) {
     delete cfg.telegram_user_mappings[telegramKey];
     config.save(cfg);
     return { success: true, message: `Unlinked ${telegramKey}` };
   }
-  
+
   return { success: false, message: `No mapping found for ${telegramKey}` };
 }
 
@@ -196,4 +195,4 @@ module.exports = {
   unlinkTelegramUser,
   getTelegramMappings,
   mapTelegramUserToHandle
-};
+};