circuit-mcp 1.0.17 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "circuit-mcp",
-  "version": "1.0.17",
+  "version": "2.0.0",
   "description": "Connect Circuit to Cursor and Claude Code - bring customer priorities and engineering briefs into your AI coding assistant",
   "type": "module",
   "bin": {

package/src/server.js

@@ -74,7 +74,7 @@ async function handleMessage(message, token) {
           protocolVersion: '2024-11-05',
           serverInfo: {
             name: 'circuit-mcp',
-            version: '1.0.0'
+            version: '2.0.0'
           },
           capabilities: {
             tools: {},
@@ -84,7 +84,6 @@ async function handleMessage(message, token) {
       };
 
     case 'initialized':
-      // No response needed for notification
       return null;
 
     case 'tools/list':
@@ -94,111 +93,114 @@ async function handleMessage(message, token) {
         result: {
           tools: [
             {
-              name: 'get_priorities',
-              description: 'Get your top priorities from Circuit, ranked by customer volume. These are the features/fixes that matter most to your users.',
+              name: 'circuit.priorities',
+              description: 'What should I work on? Get ranked priorities with confidence indicators, trends, and memory context.',
               inputSchema: {
                 type: 'object',
                 properties: {
+                  lens: {
+                    type: 'string',
+                    description: "Focus lens: 'volume', 'urgency', 'revenue', 'retention', 'delight', 'feature'",
+                    enum: ['volume', 'urgency', 'revenue', 'retention', 'delight', 'feature'],
+                    default: 'volume'
+                  },
+                  segment: {
+                    type: 'string',
+                    description: "Filter by customer segment: 'enterprise', 'smb', 'all'",
+                    default: 'all'
+                  },
                   limit: {
                     type: 'number',
-                    description: 'Number of priorities to return (default: 5, max: 20)'
+                    description: 'Number of priorities (default: 5, max: 20)',
+                    default: 5
                   },
-                  sort_by: {
+                  category: {
                     type: 'string',
-                    description: 'Sort criterion: volume, urgency, revenue, negative, positive',
-                    enum: ['volume', 'urgency', 'revenue', 'negative', 'positive']
+                    description: "Filter by category: 'Bug', 'Feature', 'Friction', 'Complaint', 'Praise'",
+                    enum: ['Bug', 'Feature', 'Friction', 'Complaint', 'Praise']
                   }
                 }
               }
             },
             {
-              name: 'get_brief',
-              description: 'Get the full engineering brief for a specific priority. Includes what to build, why it matters, customer quotes, files to touch, and done criteria.',
+              name: 'circuit.brief',
+              description: 'Get the full engineering spec for a priority. Includes brief content, customer context, version history, and related memory (previous ships, outcomes).',
               inputSchema: {
                 type: 'object',
                 properties: {
                   priority_id: {
                     type: 'string',
-                    description: 'The priority ID (from get_priorities)'
+                    description: 'The priority ID'
                   },
                   build_id: {
                     type: 'string',
                     description: 'The build ID directly (alternative to priority_id)'
+                  },
+                  include_history: {
+                    type: 'boolean',
+                    description: 'Include version history and related memory',
+                    default: true
                   }
                 }
               }
             },
             {
-              name: 'start_building',
-              description: "Mark a brief as 'building' - you're actively working on this feature.",
+              name: 'circuit.act',
+              description: 'Take an action in Circuit. Ship a brief, start building, correct a classification, or submit new feedback.',
               inputSchema: {
                 type: 'object',
                 properties: {
-                  build_id: {
+                  action: {
                     type: 'string',
-                    description: 'The build ID to mark as building'
-                  }
-                },
-                required: ['build_id']
-              }
-            },
-            {
-              name: 'mark_shipped',
-              description: "Mark a brief as 'shipped' - the feature has shipped! This closes the feedback loop and notifies customers.",
-              inputSchema: {
-                type: 'object',
-                properties: {
-                  build_id: {
+                    description: "Action to take: 'build' (start building), 'ship' (mark shipped), 'correct' (fix classification), 'submit' (add feedback)",
+                    enum: ['build', 'ship', 'correct', 'submit']
+                  },
+                  brief_id: {
                     type: 'string',
-                    description: 'The build ID to mark as shipped'
-                  }
-                },
-                required: ['build_id']
-              }
-            },
-            {
-              name: 'mark_done',
-              description: "[Deprecated - use mark_shipped] Mark a brief as shipped.",
-              inputSchema: {
-                type: 'object',
-                properties: {
-                  build_id: {
+                    description: "Brief ID (for 'build' and 'ship' actions)"
+                  },
+                  priority_id: {
                     type: 'string',
-                    description: 'The build ID to mark as shipped'
-                  }
-                },
-                required: ['build_id']
-              }
-            },
-            {
-              name: 'search_feedback',
-              description: 'Search customer feedback by keyword. Useful for understanding pain points around specific features.',
-              inputSchema: {
-                type: 'object',
-                properties: {
-                  query: {
+                    description: "Priority ID (for 'correct' action)"
+                  },
+                  correction_type: {
                     type: 'string',
-                    description: 'Search query (keywords or phrase)'
+                    description: "What to correct (for 'correct' action): 'category'",
+                    enum: ['category']
                   },
-                  limit: {
-                    type: 'number',
-                    description: 'Max results (default: 10)'
+                  original: {
+                    type: 'string',
+                    description: 'Original value being corrected'
+                  },
+                  corrected: {
+                    type: 'string',
+                    description: 'New corrected value'
+                  },
+                  feedback: {
+                    type: 'string',
+                    description: "Feedback text (for 'submit' action)"
+                  },
+                  source: {
+                    type: 'string',
+                    description: "Feedback source (for 'submit' action)",
+                    default: 'mcp'
                   }
                 },
-                required: ['query']
+                required: ['action']
               }
             },
             {
-              name: 'get_insights',
-              description: 'Get high-level insights and patterns across your priorities. Identifies themes, trends, and strategic recommendations.',
+              name: 'circuit.ask',
+              description: 'Ask anything about your feedback data. Searches across feedback, priorities, briefs, and help articles using semantic search.',
               inputSchema: {
                 type: 'object',
                 properties: {
-                  limit: {
-                    type: 'number',
-                    description: 'Number of priorities to analyze (default: 10)'
+                  question: {
+                    type: 'string',
+                    description: "Natural language question (e.g., 'What are enterprise customers complaining about?', 'How do briefs work?')"
                   }
-                }
+                },
+                required: ['question']
               }
             }
           ]
@@ -232,7 +234,7 @@ async function handleMessage(message, token) {
 }
 
 /**
- * Format priorities for display (matches Circuit UI exactly)
+ * Format priorities response
  */
 function formatPriorities(data) {
   if (data.message) {
@@ -245,47 +247,49 @@ function formatPriorities(data) {
 
   const lines = [];
 
+  if (data.memory_applied) {
+    lines.push(`*Memory active: ${data.ships_count} ships tracked, segment: ${data.segment_affinity || 'mixed'}*\n`);
+  }
+
   for (const p of data.priorities) {
-    // Format trend indicator like Circuit UI
     let trendText = '';
     if (p.trend === 'up') {
-      trendText = ' ↑';
+      trendText = ` ↑${p.trend_percent ? ` ${p.trend_percent}%` : ''}`;
     } else if (p.trend === 'down') {
-      trendText = ' ↓';
+      trendText = ` ↓${p.trend_percent ? ` ${p.trend_percent}%` : ''}`;
     }
 
-    // Format: #Rank. Title
     lines.push(`**#${p.rank}. ${p.theme}**`);
 
-    // Badges row: Category | X users | Trend | Status
     const badges = [];
     badges.push(p.category || 'Other');
     badges.push(`${p.volume} users`);
     if (trendText) badges.push(trendText.trim());
     if (p.brief_status && p.brief_status !== 'no_brief') {
-      const statusLabel = { ready: 'Ready', building: 'Building', shipped: 'Shipped', done: 'Shipped' }[p.brief_status];
+      const statusLabel = { ready: 'Ready', building: 'Building', shipped: 'Shipped' }[p.brief_status];
       if (statusLabel) badges.push(statusLabel);
     }
+    if (p.matches_pattern) badges.push('matches pattern');
+    if (p.version) badges.push(p.version);
 
     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(`priority_id: \`${p.priority_id}\`${p.build_id ? ` · build_id: \`${p.build_id}\`` : ''}`);
     lines.push('');
   }
 
   lines.push('---');
-  lines.push('Use `get_brief` with a priority_id to see the full engineering spec.');
+  lines.push('Use `circuit.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)
+ * Format brief response
  */
 function formatBrief(data) {
   if (data.error) {
@@ -293,51 +297,31 @@ function formatBrief(data) {
       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`;
+      output += `**No brief generated yet.**\n\n`;
+      if (data.suggestion) {
+        output += `${data.suggestion}\n`;
       }
-
-      if (p.key_quote) {
-        output += `> "${p.key_quote}"\n\n`;
-      }
-
-      output += `---\n\n`;
-
-      // Include deep link to Circuit
-      if (data.circuit_url) {
-        output += `**Generate brief:** ${data.circuit_url}\n\n`;
-      }
-
-      output += `Or I can help you draft implementation notes based on the customer feedback above.`;
       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 (handle both 'shipped' and legacy 'done')
-  const statusText = {
-    'ready': 'Ready',
-    'building': 'Building',
-    'shipped': 'Shipped',
-    'done': 'Shipped'
-  }[data.status] || data.status;
+  const title = data.title || 'Engineering Brief';
+  output += `# ${title}\n\n`;
+
+  const statusText = { ready: 'Ready', building: 'Building', shipped: 'Shipped' }[data.status] || data.status;
+  const versionBadge = data.version_badge ? ` · ${data.version_badge}` : '';
+  output += `Status: ${statusText}${versionBadge}\n`;
 
-  output += `Status: ${statusText}\n\n`;
+  if (data.customer_context) {
+    const ctx = data.customer_context;
+    output += `${ctx.category} · ${ctx.volume} users · ${ctx.paying_percent}% paying\n`;
+  }
+  output += '\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')
@@ -352,6 +336,19 @@ function formatBrief(data) {
 
   output += cleanSpec;
 
+  if (data.related_memory && data.related_memory.length > 0) {
+    output += '\n## WHAT CIRCUIT REMEMBERS\n\n';
+    for (const mem of data.related_memory) {
+      if (mem.type === 'ship') {
+        output += `- Shipped: ${mem.theme || mem.summary || 'Related feature'}\n`;
+      } else if (mem.type === 'correction') {
+        output += `- Correction: ${mem.summary || 'Classification adjusted'}\n`;
+      } else {
+        output += `- ${mem.summary || JSON.stringify(mem)}\n`;
+      }
+    }
+  }
+
   output += `\n---\n`;
   output += `build_id: \`${data.build_id}\``;
 
@@ -359,103 +356,76 @@ function formatBrief(data) {
 }
 
 /**
- * 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
+ * Format act response
  */
-function formatStatusChange(data) {
+function formatAct(data) {
   if (data.error) {
     return `Error: ${data.error}`;
   }
 
   if (data.success) {
-    return data.message;
+    let output = data.message;
+    if (data.memory_created) {
+      output += '\nShip memory recorded — Circuit will remember this for future briefs.';
+    }
+    return output;
   }
 
   return JSON.stringify(data, null, 2);
 }
 
 /**
- * Format insights for display
+ * Format ask response
  */
-function formatInsights(data) {
+function formatAsk(data) {
   if (data.message) {
     return data.message;
   }
 
   const lines = [];
 
-  lines.push(`## Insights from ${data.analyzed} priorities\n`);
-  lines.push(`**Total feedback volume:** ${data.total_feedback_volume} mentions\n`);
-
-  // Category breakdown
-  if (data.category_breakdown) {
-    lines.push('**Category breakdown:**');
-    for (const [cat, count] of Object.entries(data.category_breakdown)) {
-      lines.push(`- ${cat}: ${count}`);
+  if (data.help_articles && data.help_articles.length > 0) {
+    lines.push('**Help Articles:**');
+    for (const a of data.help_articles) {
+      lines.push(`- **${a.title}**: ${a.content}`);
     }
     lines.push('');
   }
 
-  // Top 3 by volume
-  if (data.top_3_by_volume && data.top_3_by_volume.length > 0) {
-    lines.push('**Top priorities by volume:**');
-    for (const p of data.top_3_by_volume) {
-      lines.push(`- ${p.theme} (${p.volume} users, ${p.category})`);
+  if (data.priorities && data.priorities.length > 0) {
+    lines.push('**Related Priorities:**');
+    for (const p of data.priorities) {
+      lines.push(`- ${p.theme} (${p.category}, ${p.volume} users) — priority_id: \`${p.id}\``);
     }
     lines.push('');
   }
 
-  // Trends
-  if (data.trending_up && data.trending_up.length > 0) {
-    lines.push(`**Trending up:** ${data.trending_up.join(', ')}`);
-  }
-  if (data.trending_down && data.trending_down.length > 0) {
-    lines.push(`**Trending down:** ${data.trending_down.join(', ')}`);
-  }
-
-  // High urgency
-  if (data.high_urgency && data.high_urgency.length > 0) {
-    lines.push('\n**High urgency items:**');
-    for (const h of data.high_urgency) {
-      lines.push(`- ${h.theme} (urgency: ${h.urgency})`);
+  if (data.feedback && data.feedback.length > 0) {
+    lines.push('**Related Feedback:**');
+    for (const f of data.feedback) {
+      lines.push(`- [${f.source}] "${f.text}"`);
     }
+    lines.push('');
   }
 
-  // Recommendations
-  if (data.recommendations && data.recommendations.length > 0) {
-    lines.push('\n**Recommendations:**');
-    for (const r of data.recommendations) {
-      lines.push(`- ${r}`);
+  if (data.your_patterns) {
+    const pat = data.your_patterns;
+    lines.push('**Your Patterns:**');
+    lines.push(`- Ships: ${pat.ships_count}`);
+    lines.push(`- Segment: ${pat.segment_affinity}`);
+    if (pat.top_categories) {
+      const cats = Object.entries(pat.top_categories).map(([k, v]) => `${k} (${Math.round(v * 100)}%)`).join(', ');
+      lines.push(`- Top categories: ${cats}`);
     }
+    lines.push('');
   }
 
-  lines.push('\n---');
-  if (data.circuit_url) {
-    lines.push(`View full details: ${data.circuit_url}`);
+  if (lines.length === 0) {
+    return `No results found for "${data.question}". Try rephrasing.`;
   }
 
+  lines.push(`---\n${data.total} results found`);
+
   return lines.join('\n');
 }
 
@@ -466,29 +436,22 @@ async function handleToolCall(id, params, token) {
   const { name, arguments: args } = params;
 
   try {
-    // 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':
+      case 'circuit.priorities':
         formattedText = formatPriorities(result);
         break;
-      case 'get_brief':
+      case 'circuit.brief':
         formattedText = formatBrief(result);
         break;
-      case 'search_feedback':
-        formattedText = formatSearchResults(result);
+      case 'circuit.act':
+        formattedText = formatAct(result);
         break;
-      case 'start_building':
-      case 'mark_shipped':
-      case 'mark_done':
-        formattedText = formatStatusChange(result);
-        break;
-      case 'get_insights':
-        formattedText = formatInsights(result);
+      case 'circuit.ask':
+        formattedText = formatAsk(result);
         break;
       default:
         formattedText = JSON.stringify(result, null, 2);
@@ -510,4 +473,3 @@ async function handleToolCall(id, params, token) {
     };
   }
 }
-