circuit-mcp 1.0.13 → 1.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "circuit-mcp",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Circuit MCP server for Cursor and Claude Code",
   "type": "module",
   "bin": {

package/src/server.js

@@ -204,6 +204,160 @@ async function handleMessage(message, token) {
   }
 }
 
+/**
+ * Format priorities for display (matches Circuit UI exactly)
+ */
+function formatPriorities(data) {
+  if (data.message) {
+    return data.message;
+  }
+
+  if (!data.priorities || data.priorities.length === 0) {
+    return 'No priorities found. Upload feedback to Circuit to get started.';
+  }
+
+  const lines = [];
+
+  for (const p of data.priorities) {
+    // Format trend indicator like Circuit UI
+    let trendText = '';
+    if (p.trend === 'up') {
+      trendText = ' ↑';
+    } else if (p.trend === 'down') {
+      trendText = ' ↓';
+    }
+
+    // Format: #Rank. Title
+    lines.push(`**#${p.rank}. ${p.theme}**`);
+
+    // Badges row: Category | X users | Trend
+    const badges = [];
+    badges.push(p.category || 'Other');
+    badges.push(`${p.volume} users`);
+    if (trendText) badges.push(trendText.trim());
+
+    lines.push(badges.join(' · '));
+
+    // Key quote (customer voice)
+    if (p.key_quote) {
+      lines.push(`> "${p.key_quote}"`);
+    }
+
+    lines.push(`priority_id: \`${p.id}\``);
+    lines.push('');
+  }
+
+  lines.push('---');
+  lines.push('Use `get_brief` with a priority_id to see the full engineering spec.');
+
+  return lines.join('\n');
+}
+
+/**
+ * Format brief for display (matches Circuit UI format for Cursor/Claude)
+ */
+function formatBrief(data) {
+  if (data.error) {
+    if (data.error === 'no_brief' && data.priority) {
+      const p = data.priority;
+      let output = `# ${p.theme || 'Priority'}\n\n`;
+      output += `${p.category || 'Other'} · ${p.volume || 0} users\n\n`;
+      output += `**No brief generated yet**\n\n`;
+
+      if (p.summary) {
+        output += `${p.summary}\n\n`;
+      }
+
+      if (p.key_quote) {
+        output += `> "${p.key_quote}"\n\n`;
+      }
+
+      output += `---\n`;
+      output += data.suggestion;
+      return output;
+    }
+    return `Error: ${data.message || data.error}`;
+  }
+
+  const spec = data.spec_content || '';
+
+  // Build header like Circuit UI exports
+  // Format: # Title
+  // Priority: #X | Mentions: Y | Type: Z
+  // ---
+  // {spec content}
+
+  let output = '';
+
+  // Status line
+  const statusText = {
+    'ready': 'Ready',
+    'building': 'Building',
+    'done': 'Done'
+  }[data.status] || data.status;
+
+  output += `Status: ${statusText}\n\n`;
+
+  // The spec_content should already be formatted markdown
+  // Clean up any XML-style tags to proper headers
+  let cleanSpec = spec
+    .replace(/<what_to_build>/gi, '## WHAT TO BUILD\n')
+    .replace(/<\/what_to_build>/gi, '\n')
+    .replace(/<why_it_matters>/gi, '## WHY IT MATTERS\n')
+    .replace(/<\/why_it_matters>/gi, '\n')
+    .replace(/<customer_voice>/gi, '## CUSTOMER VOICE\n')
+    .replace(/<\/customer_voice>/gi, '\n')
+    .replace(/<files_to_touch>/gi, '## FILES TO TOUCH\n')
+    .replace(/<\/files_to_touch>/gi, '\n')
+    .replace(/<done_when>/gi, '## DONE WHEN\n')
+    .replace(/<\/done_when>/gi, '\n');
+
+  output += cleanSpec;
+
+  output += `\n---\n`;
+  output += `build_id: \`${data.build_id}\``;
+
+  return output;
+}
+
+/**
+ * Format search results for display
+ */
+function formatSearchResults(data) {
+  if (data.message) {
+    return data.message;
+  }
+
+  if (!data.results || data.results.length === 0) {
+    return 'No feedback found matching your search.';
+  }
+
+  const lines = [`**${data.total} results found**\n`];
+
+  for (const f of data.results) {
+    lines.push(`**${f.source}** · Urgency: ${f.urgency}/5`);
+    lines.push(`> "${f.text}"`);
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Format status change response
+ */
+function formatStatusChange(data) {
+  if (data.error) {
+    return `Error: ${data.error}`;
+  }
+
+  if (data.success) {
+    return data.message;
+  }
+
+  return JSON.stringify(data, null, 2);
+}
+
 /**
  * Handle tool calls
  */
@@ -214,11 +368,32 @@ async function handleToolCall(id, params, token) {
     // Call the Circuit MCP backend
     const result = await callMcpApi(token, name, args || {});
 
+    // Format response based on tool type
+    let formattedText;
+
+    switch (name) {
+      case 'get_priorities':
+        formattedText = formatPriorities(result);
+        break;
+      case 'get_brief':
+        formattedText = formatBrief(result);
+        break;
+      case 'search_feedback':
+        formattedText = formatSearchResults(result);
+        break;
+      case 'start_building':
+      case 'mark_done':
+        formattedText = formatStatusChange(result);
+        break;
+      default:
+        formattedText = JSON.stringify(result, null, 2);
+    }
+
     return {
       jsonrpc: '2.0',
       id,
       result: {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
+        content: [{ type: 'text', text: formattedText }]
       }
     };