slashvibe-mcp 0.2.9 → 0.3.13

package/tools/gig-browse.js

@@ -0,0 +1,206 @@
+/**
+ * vibe_gig_browse - Browse and filter the gig marketplace
+ *
+ * Search for gigs by category, skills, budget range, etc.
+ */
+
+const config = require('../config');
+const { requireInit, displayHandle, header, divider, emptyState, formatTimeAgo } = require('./_shared');
+
+const BASE_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+
+const definition = {
+  name: 'vibe_gig_browse',
+  description: 'Browse the gig marketplace. Filter by category, skills, budget, or search by keyword.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      category: {
+        type: 'string',
+        enum: ['build', 'fix', 'design', 'review', 'teach', 'consult', 'other'],
+        description: 'Filter by gig category'
+      },
+      skill: {
+        type: 'string',
+        description: 'Filter by required skill (e.g., "react", "python", "api")'
+      },
+      min_budget: {
+        type: 'number',
+        description: 'Minimum budget in dollars'
+      },
+      max_budget: {
+        type: 'number',
+        description: 'Maximum budget in dollars'
+      },
+      search: {
+        type: 'string',
+        description: 'Search in title and description'
+      },
+      limit: {
+        type: 'number',
+        description: 'Number of results (default: 10, max: 50)'
+      }
+    }
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  const {
+    category,
+    skill,
+    min_budget,
+    max_budget,
+    search,
+    limit = 10
+  } = args;
+
+  try {
+    // Build query string
+    const params = new URLSearchParams();
+    params.set('status', 'open');
+    params.set('limit', Math.min(limit, 50).toString());
+
+    // Note: API may not support all filters yet, but we include them
+    if (category) params.set('category', category);
+    if (skill) params.set('skill', skill);
+    if (min_budget) params.set('min_budget', min_budget.toString());
+    if (max_budget) params.set('max_budget', max_budget.toString());
+    if (search) params.set('search', search);
+
+    const response = await fetch(`${BASE_URL}/api/gigs?${params.toString()}`);
+    const data = await response.json();
+
+    // Handle coming soon state
+    if (data.coming_soon) {
+      return {
+        display: header('🚀 Gigs Marketplace', 2) + '\n\n' +
+          '┌────────────────────────────────────────┐\n' +
+          '│       LAUNCHING WEDNESDAY JAN 22       │\n' +
+          '└────────────────────────────────────────┘\n\n' +
+          'The gigs marketplace is almost ready!\n\n' +
+          '• Post gigs to hire builders\n' +
+          '• Apply to gigs and get paid\n' +
+          '• Build your proof-of-work reputation\n\n' +
+          'Stay tuned for the launch!'
+      };
+    }
+
+    if (!data.success) {
+      return { display: `❌ ${data.error || 'Failed to browse gigs'}` };
+    }
+
+    const gigs = data.gigs || [];
+
+    // Filter client-side if API doesn't support all filters
+    let filteredGigs = gigs;
+
+    // Client-side category filter
+    if (category) {
+      filteredGigs = filteredGigs.filter(g => g.category === category);
+    }
+
+    // Client-side skill filter (API uses skills_needed)
+    if (skill) {
+      const lowerSkill = skill.toLowerCase();
+      filteredGigs = filteredGigs.filter(g => {
+        const skills = g.skills_needed || [];
+        return skills.some(s => s.toLowerCase().includes(lowerSkill));
+      });
+    }
+
+    // Client-side budget filter (API uses budget object with min/max in dollars)
+    if (min_budget) {
+      filteredGigs = filteredGigs.filter(g => {
+        const budgetMin = g.budget?.min || 0;
+        return budgetMin >= min_budget;
+      });
+    }
+    if (max_budget) {
+      filteredGigs = filteredGigs.filter(g => {
+        const budgetMax = g.budget?.max || Infinity;
+        return budgetMax <= max_budget;
+      });
+    }
+
+    // Client-side search
+    if (search) {
+      const lowerSearch = search.toLowerCase();
+      filteredGigs = filteredGigs.filter(g =>
+        (g.title || '').toLowerCase().includes(lowerSearch) ||
+        (g.description || '').toLowerCase().includes(lowerSearch)
+      );
+    }
+
+    if (filteredGigs.length === 0) {
+      let hint = 'Try broadening your search criteria.';
+      if (category || skill) {
+        hint = `No gigs found matching your filters. Try removing some filters.`;
+      }
+      return { display: emptyState('No open gigs found', hint) };
+    }
+
+    // Build display
+    let display = header('🎯 Open Gigs', 2) + '\n\n';
+
+    // Show active filters
+    const filters = [];
+    if (category) filters.push(`category: ${category}`);
+    if (skill) filters.push(`skill: ${skill}`);
+    if (min_budget || max_budget) {
+      const budgetStr = min_budget && max_budget
+        ? `$${min_budget}-$${max_budget}`
+        : min_budget ? `≥$${min_budget}` : `≤$${max_budget}`;
+      filters.push(`budget: ${budgetStr}`);
+    }
+    if (search) filters.push(`search: "${search}"`);
+
+    if (filters.length > 0) {
+      display += `_Filters: ${filters.join(', ')}_\n\n`;
+    }
+
+    display += `Found **${filteredGigs.length}** gig${filteredGigs.length !== 1 ? 's' : ''}\n\n`;
+
+    // List gigs (API returns: poster, budget{min,max}, skills_needed, applicants as count)
+    filteredGigs.forEach((gig, i) => {
+      display += `**${i + 1}. ${gig.title}**\n`;
+      display += `   ${displayHandle(gig.poster)} • `;
+
+      // Budget is an object with min/max in dollars
+      const budgetDisplay = gig.budget
+        ? `$${gig.budget.min || 0}-$${gig.budget.max || '?'}`
+        : 'TBD';
+      display += `${budgetDisplay} • `;
+      display += `${gig.category || 'other'}\n`;
+
+      if (gig.skills_needed && gig.skills_needed.length > 0) {
+        display += `   Skills: ${gig.skills_needed.slice(0, 5).join(', ')}\n`;
+      }
+
+      if (gig.description) {
+        const shortDesc = gig.description.slice(0, 100);
+        display += `   _${shortDesc}${gig.description.length > 100 ? '...' : ''}_\n`;
+      }
+
+      // API returns applicants as a count (number), not array
+      const applicantCount = typeof gig.applicants === 'number' ? gig.applicants : 0;
+      display += `   ${applicantCount} applicant${applicantCount !== 1 ? 's' : ''} • `;
+      display += `posted ${formatTimeAgo(gig.created_at)}\n`;
+
+      display += `   **ID:** ${gig.id}\n\n`;
+    });
+
+    display += divider();
+    display += '💡 Apply to a gig with: `apply to gig [gig_id]`';
+
+    return { display };
+
+  } catch (e) {
+    console.error('[gig-browse] Error:', e);
+    return { display: `❌ Failed to browse gigs: ${e.message}` };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/gig-complete.js

@@ -0,0 +1,144 @@
+/**
+ * vibe_gig_complete - Mark a gig as completed
+ *
+ * When a gig is completed:
+ * - Links deliverables (session, artifacts, notes)
+ * - Boosts hired person's reputation
+ * - Auto-posts celebration to the board
+ * - Records rating
+ */
+
+const config = require('../config');
+const { requireInit, normalizeHandle, displayHandle, success, error, header, divider } = require('./_shared');
+const { actions, formatActions } = require('./_actions');
+
+const BASE_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
+
+const definition = {
+  name: 'vibe_gig_complete',
+  description: 'Mark a gig as completed with deliverables and rating. Boosts reputation and posts to board.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      gig_id: {
+        type: 'string',
+        description: 'The gig ID to complete (e.g., gig_abc123)'
+      },
+      session_id: {
+        type: 'string',
+        description: 'Optional: Link a session as primary deliverable'
+      },
+      artifact_ids: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Optional: Array of artifact IDs created during the gig'
+      },
+      notes: {
+        type: 'string',
+        description: 'Optional: Completion notes or summary'
+      },
+      rating: {
+        type: 'number',
+        minimum: 1,
+        maximum: 5,
+        description: 'Rating for the hired person (1-5 stars)'
+      }
+    },
+    required: ['gig_id', 'rating']
+  }
+};
+
+async function handler(args) {
+  const initCheck = requireInit();
+  if (initCheck) return initCheck;
+
+  // Check if gigs are enabled by making a quick check
+  try {
+    const checkResponse = await fetch(`${BASE_URL}/api/gigs`);
+    const checkData = await checkResponse.json();
+    if (checkData.coming_soon) {
+      return {
+        display: header('🚀 Gigs Marketplace', 2) + '\n\n' +
+          'Launching Wednesday Jan 22!\n\n' +
+          'Gig completion will be available after launch.'
+      };
+    }
+  } catch (e) {
+    // Continue with request if check fails
+  }
+
+  const {
+    gig_id,
+    session_id = null,
+    artifact_ids = [],
+    notes = null,
+    rating
+  } = args;
+
+  const handle = config.getHandle();
+
+  // Validate rating
+  if (rating < 1 || rating > 5) {
+    return { display: error('Rating must be between 1 and 5 stars') };
+  }
+
+  try {
+    const response = await fetch(`${BASE_URL}/api/gigs/complete`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        gig_id,
+        completed_by: handle,
+        deliverables: {
+          session_id,
+          artifact_ids,
+          notes
+        },
+        rating
+      })
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      return { display: error(data.error || 'Failed to complete gig') };
+    }
+
+    // Format success display
+    let display = success('Gig Completed!') + '\n\n';
+
+    display += header('Gig Details', 3) + '\n';
+    display += `**Title:** ${data.gig?.title || gig_id}\n`;
+    display += `**Hired:** ${displayHandle(data.gig?.hired_handle)}\n`;
+    display += `**Rating:** ${'⭐'.repeat(rating)}\n`;
+
+    if (session_id) {
+      display += `**Session:** ${session_id}\n`;
+    }
+    if (artifact_ids.length > 0) {
+      display += `**Artifacts:** ${artifact_ids.length} linked\n`;
+    }
+    if (notes) {
+      display += `**Notes:** ${notes}\n`;
+    }
+
+    display += divider();
+    display += `${displayHandle(data.gig?.hired_handle)} earned **+50 vibe points** for completing this gig!\n`;
+
+    if (data.posted_to_board) {
+      display += `\n🎉 Celebration posted to the board`;
+    }
+
+    // Build result with bonus tip action
+    const result = { display };
+    result.actions = formatActions(actions.afterGigComplete(data.gig));
+
+    return result;
+
+  } catch (e) {
+    console.error('[gig-complete] Error:', e);
+    return { display: error(`Failed to complete gig: ${e.message}`) };
+  }
+}
+
+module.exports = { definition, handler };

package/tools/handoff.js

@@ -15,7 +15,13 @@ const HANDOFF_VERSION = '1.0';
 
 const definition = {
   name: 'vibe_handoff',
-  description: 'Transfer task context to another agent. Search triggers: "hand off", "delegate", "transfer", "pass to", "coordinate", "agent collaboration". Enables AIRC context portability - includes repo, files, state, blockers. Receiving agent can resume immediately.',
+  description: `Hand off a task to another agent with full context. Use when:
+- You're stuck and need another agent to continue
+- Shifting to a different domain/expertise
+- Ending your session but work needs to continue
+- Delegating a subtask
+
+The receiving agent gets structured context to resume work immediately.`,
   inputSchema: {
     type: 'object',
     properties: {

package/tools/help.js

@@ -192,12 +192,12 @@ Presence updates every 5 minutes. Run \`vibe who\` for fresh data.
 
 ### Need help?
 - DM \`@echo\` with your question
-- DM \`@seth\` for direct support
+- DM \`@vibe\` for support
 - DM \`@discovery-agent\` for connection help
 - Post on the board with category "question"
 
 ### Report Issues
-- GitHub: https://github.com/brightseth/vibe/issues
+- GitHub: https://github.com/VibeCodingInc/vibe-mcp/issues
 - Or: \`vibe echo "your feedback"\``;
 
 async function handler(args) {
@@ -236,7 +236,7 @@ Available topics:
   }
 
   // Default: overview
-  let display = `## /vibe Help
+  const display = `## /vibe Help
 
 ${isInitialized ? `You're **@${handle}**` : '⚠️ Not initialized yet — run `vibe init @yourhandle`'}
 
@@ -260,7 +260,7 @@ ${isInitialized ? `You're **@${handle}**` : '⚠️ Not initialized yet — run
 
 ### Links
 - Docs: https://slashvibe.dev/llms.txt
-- Issues: https://github.com/brightseth/vibe/issues
+- Issues: https://github.com/VibeCodingInc/vibe-mcp/issues
 - Feedback: \`vibe echo "message"\``;
 
   return { display };

package/tools/idea.js

@@ -84,9 +84,16 @@ async function handler(args) {
     }
 
     try {
+      // Include auth token for API authorization
+      const authToken = config.getAuthToken();
+      const headers = { 'Content-Type': 'application/json' };
+      if (authToken) {
+        headers['Authorization'] = `Bearer ${authToken}`;
+      }
+
       const response = await fetch(`${apiUrl}/api/board`, {
         method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
+        headers,
         body: JSON.stringify(entry)
       });
 
@@ -123,7 +130,7 @@ async function handler(args) {
   // Browse ideas
   try {
     const limit = Math.min(args.limit || 10, 30);
-    let url = `${apiUrl}/api/board?limit=${limit}&category=idea`;
+    const url = `${apiUrl}/api/board?limit=${limit}&category=idea`;
 
     // Also fetch riffs
     const riffUrl = `${apiUrl}/api/board?limit=${limit}&category=riff`;