circuit-mcp 2.0.1 → 2.3.0

package/src/server.js

@@ -1,6 +1,7 @@
 import { createInterface } from 'readline';
 
-const CIRCUIT_API = 'https://rnb3tf4uk3.ap-southeast-2.awsapprunner.com';
+const CIRCUIT_API = process.env.CIRCUIT_API_URL || 'https://api.withcircuit.com';
+const API_TIMEOUT_MS = 30_000;
 
 /**
  * Start MCP server in stdio mode
@@ -13,7 +14,6 @@ export async function startMcpServer(token) {
     terminal: false
   });
 
-  // Handle incoming JSON-RPC messages
   rl.on('line', async (line) => {
     try {
       const message = JSON.parse(line);
@@ -22,7 +22,6 @@ export async function startMcpServer(token) {
         console.log(JSON.stringify(response));
       }
     } catch (err) {
-      // Send error response
       console.log(JSON.stringify({
         jsonrpc: '2.0',
         error: { code: -32700, message: 'Parse error' },
@@ -31,32 +30,45 @@ export async function startMcpServer(token) {
     }
   });
 
-  // Keep process alive
   process.stdin.resume();
 }
 
 /**
- * Call Circuit MCP backend API
+ * Call Circuit backend API with timeout
  */
 async function callMcpApi(token, toolName, args = {}) {
-  const response = await fetch(`${CIRCUIT_API}/mcp/call`, {
-    method: 'POST',
-    headers: {
-      'Authorization': `Bearer ${token}`,
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify({
-      tool: toolName,
-      arguments: args
-    })
-  });
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
 
-  if (!response.ok) {
-    const text = await response.text();
-    throw new Error(`API error ${response.status}: ${text}`);
-  }
+  try {
+    const response = await fetch(`${CIRCUIT_API}/mcp/call`, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({ tool: toolName, arguments: args }),
+      signal: controller.signal
+    });
+
+    if (response.status === 401) {
+      throw new Error('Token expired. Run: npx circuit-mcp auth');
+    }
 
-  return response.json();
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`API error ${response.status}: ${text}`);
+    }
+
+    return response.json();
+  } catch (err) {
+    if (err.name === 'AbortError') {
+      throw new Error('Request timed out. Check your connection and try again.');
+    }
+    throw err;
+  } finally {
+    clearTimeout(timeout);
+  }
 }
 
 /**
@@ -72,14 +84,8 @@ async function handleMessage(message, token) {
         id,
         result: {
           protocolVersion: '2024-11-05',
-          serverInfo: {
-            name: 'circuit-mcp',
-            version: '2.0.0'
-          },
-          capabilities: {
-            tools: {},
-            resources: {}
-          }
+          serverInfo: { name: 'circuit-mcp', version: '2.2.0' },
+          capabilities: { tools: {}, resources: {} }
         }
       };
 
@@ -87,142 +93,16 @@ async function handleMessage(message, token) {
       return null;
 
     case 'tools/list':
-      return {
-        jsonrpc: '2.0',
-        id,
-        result: {
-          tools: [
-            {
-              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 (default: 5, max: 20)',
-                    default: 5
-                  },
-                  category: {
-                    type: 'string',
-                    description: "Filter by category: 'Bug', 'Feature', 'Friction', 'Complaint', 'Praise'",
-                    enum: ['Bug', 'Feature', 'Friction', 'Complaint', 'Praise']
-                  }
-                }
-              }
-            },
-            {
-              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'
-                  },
-                  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: 'circuit.act',
-              description: 'Take an action in Circuit. Ship a brief, start building, correct a classification, or submit new feedback.',
-              inputSchema: {
-                type: 'object',
-                properties: {
-                  action: {
-                    type: 'string',
-                    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: "Brief ID (for 'build' and 'ship' actions)"
-                  },
-                  priority_id: {
-                    type: 'string',
-                    description: "Priority ID (for 'correct' action)"
-                  },
-                  correction_type: {
-                    type: 'string',
-                    description: "What to correct (for 'correct' action): 'category'",
-                    enum: ['category']
-                  },
-                  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: ['action']
-              }
-            },
-            {
-              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: {
-                  question: {
-                    type: 'string',
-                    description: "Natural language question (e.g., 'What are enterprise customers complaining about?', 'How do briefs work?')"
-                  }
-                },
-                required: ['question']
-              }
-            }
-          ]
-        }
-      };
+      return { jsonrpc: '2.0', id, result: { tools: TOOLS } };
 
     case 'tools/call':
       return await handleToolCall(id, params, token);
 
     case 'resources/list':
-      return {
-        jsonrpc: '2.0',
-        id,
-        result: { resources: [] }
-      };
+      return { jsonrpc: '2.0', id, result: { resources: [] } };
 
     case 'ping':
-      return {
-        jsonrpc: '2.0',
-        id,
-        result: {}
-      };
+      return { jsonrpc: '2.0', id, result: {} };
 
     default:
       return {
@@ -233,96 +113,264 @@ async function handleMessage(message, token) {
   }
 }
 
-/**
- * Format priorities response
- */
-function formatPriorities(data) {
-  if (data.message) {
-    return data.message;
+// ─────────────────────────────────────────────────────────────
+// Tool Definitions
+// ─────────────────────────────────────────────────────────────
+
+const TOOLS = [
+  {
+    name: 'circuit.priorities',
+    description: 'What should I work on? Ranked customer priorities with trend data, confidence indicators, and pattern matching. Set weekly: true to get the weekly digest instead.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        weekly: {
+          type: 'boolean',
+          description: 'Set to true to get the weekly digest: priority movements, new entries, dropped items, and volume spikes compared to last week'
+        },
+        lens: {
+          type: 'string',
+          description: "How to rank: 'volume' (most users), 'urgency' (bugs & quality), 'revenue' (revenue impact), 'retention' (negative sentiment), 'delight' (positive sentiment), 'feature' (new feature requests)",
+          enum: ['volume', 'urgency', 'revenue', 'retention', 'delight', 'feature'],
+          default: 'volume'
+        },
+        segment: {
+          type: 'string',
+          description: "Customer segment filter: 'enterprise', 'smb', 'all'",
+          default: 'all'
+        },
+        limit: {
+          type: 'number',
+          description: 'Number of priorities to return (default: 5, max: 20)',
+          default: 5
+        },
+        category: {
+          type: 'string',
+          description: "Filter by feedback category",
+          enum: ['Bug', 'Feature', 'Improvement', 'Praise']
+        }
+      }
+    }
+  },
+  {
+    name: 'circuit.spec',
+    description: 'Full engineering spec for a priority. 5 sections: What to Build, Why It Matters, Customer Voice, Files to Touch, Done When. Set batch: true to export multiple specs as markdown.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        priority_id: {
+          type: 'string',
+          description: 'The priority ID (from circuit.priorities)'
+        },
+        spec_id: {
+          type: 'string',
+          description: 'The spec ID directly (alternative to priority_id)'
+        },
+        include_history: {
+          type: 'boolean',
+          description: 'Include version history and related ship memory',
+          default: true
+        },
+        batch: {
+          type: 'boolean',
+          description: 'Set to true to export multiple specs as markdown for sprint planning'
+        },
+        spec_ids: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Specific spec IDs to export (batch mode). If empty, exports recent specs.'
+        },
+        status: {
+          type: 'string',
+          description: "Filter by status (batch mode): 'ready', 'building', 'shipped'",
+          enum: ['ready', 'building', 'shipped', 'done']
+        },
+        limit: {
+          type: 'number',
+          description: 'Number of specs to export in batch mode (default: 10, max: 50)',
+          default: 10
+        }
+      }
+    }
+  },
+  {
+    name: 'circuit.act',
+    description: "Take action. Start building, ship it, share back with customers, assign, correct a classification, submit feedback, or submit a transcript.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          description: "'build' (start building), 'ship' (mark shipped), 'share' (notify customers via email/widget), 'assign' (assign to team member), 'correct' (fix classification), 'submit' (add feedback), 'transcript' (submit a transcript)",
+          enum: ['build', 'ship', 'share', 'assign', 'correct', 'submit', 'transcript']
+        },
+        spec_id: {
+          type: 'string',
+          description: "Spec ID (for build, ship, share, assign)"
+        },
+        channel: {
+          type: 'string',
+          description: "Notification channel for share: 'email', 'widget', 'both', 'skip'",
+          enum: ['email', 'widget', 'both', 'skip']
+        },
+        message: {
+          type: 'string',
+          description: "Custom message to include in share notifications (optional)"
+        },
+        assigned_to: {
+          type: 'string',
+          description: "Team member email or user ID (for assign). Empty to unassign."
+        },
+        priority_id: {
+          type: 'string',
+          description: "Priority ID (for correct)"
+        },
+        correction_type: {
+          type: 'string',
+          description: "What to correct: 'category'",
+          enum: ['category']
+        },
+        original: {
+          type: 'string',
+          description: 'Original value being corrected'
+        },
+        corrected: {
+          type: 'string',
+          description: 'New corrected value'
+        },
+        feedback: {
+          type: 'string',
+          description: "Feedback text (for submit)"
+        },
+        source: {
+          type: 'string',
+          description: "Feedback source (for submit)",
+          default: 'mcp'
+        },
+        text: {
+          type: 'string',
+          description: 'Full transcript text, min 50 chars (for transcript)'
+        },
+        title: {
+          type: 'string',
+          description: "Transcript title, e.g. 'Sales call with Acme Corp' (for transcript)"
+        },
+        type: {
+          type: 'string',
+          description: "Transcript type (for transcript)",
+          enum: ['interview', 'sales_call', 'support', 'other']
+        },
+        customer_name: {
+          type: 'string',
+          description: 'Customer name (for transcript, optional)'
+        },
+        customer_email: {
+          type: 'string',
+          description: 'Customer email (for transcript, optional)'
+        },
+        revenue_band: {
+          type: 'string',
+          description: "Customer segment (for transcript): 'enterprise', 'paid', 'free'",
+          enum: ['enterprise', 'paid', 'free']
+        }
+      },
+      required: ['action']
+    }
+  },
+  {
+    name: 'circuit.ask',
+    description: 'Search across all your feedback data. Semantic search over feedback, priorities, briefs, and help articles. Also returns your shipping patterns and behavioral insights.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        question: {
+          type: 'string',
+          description: "Natural language question, e.g. 'What are enterprise customers complaining about?'"
+        }
+      },
+      required: ['question']
+    }
   }
+];
 
-  if (!data.priorities || data.priorities.length === 0) {
-    return 'No priorities found. Upload feedback to Circuit to get started.';
+// ─────────────────────────────────────────────────────────────
+// Response Formatting
+// ─────────────────────────────────────────────────────────────
+
+function formatPriorities(data) {
+  // Weekly digest mode — detected by presence of movements/new_entries/headline
+  if (data.headline !== undefined || data.movements !== undefined) {
+    return formatWeeklyDigest(data);
   }
 
+  if (data.message) return data.message;
+  if (!data.priorities?.length) return 'No priorities found. Upload feedback to get started.';
+
   const lines = [];
 
   if (data.memory_applied) {
-    lines.push(`*Memory active: ${data.ships_count} ships tracked, segment: ${data.segment_affinity || 'mixed'}*\n`);
+    lines.push(`*${data.ships_count} ships tracked · segment: ${data.segment_affinity || 'mixed'}*\n`);
   }
 
   for (const p of data.priorities) {
-    let trendText = '';
-    if (p.trend === 'up') {
-      trendText = ` ↑${p.trend_percent ? ` ${p.trend_percent}%` : ''}`;
-    } else if (p.trend === 'down') {
-      trendText = ` ↓${p.trend_percent ? ` ${p.trend_percent}%` : ''}`;
-    }
-
     lines.push(`**#${p.rank}. ${p.theme}**`);
 
-    const badges = [];
-    badges.push(p.category || 'Other');
-    badges.push(`${p.volume} users`);
-    if (trendText) badges.push(trendText.trim());
+    const meta = [p.category || 'Other', `${p.volume} users`];
+    if (p.trend === 'up') meta.push(`↑${p.trend_percent ? ` ${p.trend_percent}%` : ''}`);
+    if (p.trend === 'down') meta.push(`↓${p.trend_percent ? ` ${p.trend_percent}%` : ''}`);
     if (p.brief_status && p.brief_status !== 'no_brief') {
-      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(' · '));
-
-    if (p.key_quote) {
-      lines.push(`> "${p.key_quote}"`);
+      const label = { ready: 'Ready', building: 'Building', shipped: 'Shipped' }[p.brief_status];
+      if (label) meta.push(label);
     }
+    if (p.matches_pattern) meta.push('matches pattern');
+    if (p.version) meta.push(p.version);
+    lines.push(meta.join(' · '));
 
-    lines.push(`priority_id: \`${p.priority_id}\`${p.build_id ? ` · build_id: \`${p.build_id}\`` : ''}`);
+    if (p.key_quote) lines.push(`> "${p.key_quote}"`);
+    lines.push(`priority_id: \`${p.priority_id}\`${p.build_id ? ` · spec_id: \`${p.build_id}\`` : ''}`);
     lines.push('');
   }
 
   lines.push('---');
-  lines.push('Use `circuit.brief` with a priority_id to see the full engineering spec.');
+  lines.push('Use `circuit.spec` with a priority_id to get the full spec.');
 
   return lines.join('\n');
 }
 
-/**
- * Format brief response
- */
-function formatBrief(data) {
+function formatSpec(data) {
+  // Batch export mode — detected by presence of markdown/count
+  if (data.markdown !== undefined) {
+    return formatBatchExport(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 (data.suggestion) {
-        output += `${data.suggestion}\n`;
-      }
-      return output;
+      return `# ${p.theme || 'Priority'}\n\n${p.category || 'Other'} · ${p.volume || 0} users\n\n**No brief generated yet.**\n\n${data.suggestion || ''}`;
     }
     return `Error: ${data.message || data.error}`;
   }
 
   const spec = data.spec_content || '';
-  let output = '';
-
   const title = data.title || 'Engineering Brief';
-  output += `# ${title}\n\n`;
+  const status = { ready: 'Ready', building: 'Building', shipped: 'Shipped' }[data.status] || data.status;
+  const version = data.version_badge ? ` · ${data.version_badge}` : '';
 
-  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`;
+  let output = `# ${title}\n\nStatus: ${status}${version}\n`;
 
   if (data.customer_context) {
     const ctx = data.customer_context;
     output += `${ctx.category} · ${ctx.volume} users · ${ctx.paying_percent}% paying\n`;
   }
+
+  if (data.effort) {
+    const e = data.effort;
+    output += `Effort: ${e.files} file${e.files !== 1 ? 's' : ''} · ${e.label}\n`;
+  }
+
   output += '\n';
 
-  let cleanSpec = spec
+  output += 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')
@@ -334,39 +382,31 @@ function formatBrief(data) {
     .replace(/<done_when>/gi, '## DONE WHEN\n')
     .replace(/<\/done_when>/gi, '\n');
 
-  output += cleanSpec;
-
-  if (data.related_memory && data.related_memory.length > 0) {
+  if (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 += `- ${mem.summary || mem.theme || JSON.stringify(mem)}\n`;
     }
   }
 
-  output += `\n---\n`;
-  output += `build_id: \`${data.build_id}\``;
+  output += `\n---\nspec_id: \`${data.build_id}\``;
 
   return output;
 }
 
-/**
- * Format act response
- */
 function formatAct(data) {
-  if (data.error) {
-    return `Error: ${data.error}`;
-  }
+  if (data.error) return `Error: ${data.error}`;
 
   if (data.success) {
     let output = data.message;
     if (data.memory_created) {
-      output += '\nShip memory recorded — Circuit will remember this for future briefs.';
+      output += '\nShip memory recorded. Circuit will remember this for future specs.';
+    }
+    if (data.transcript_id) {
+      output += `\n\ntranscript_id: \`${data.transcript_id}\``;
+    }
+    if (data.spec_id && data.action === 'share') {
+      output += `\n\nspec_id: \`${data.spec_id}\``;
     }
     return output;
   }
@@ -374,17 +414,12 @@ function formatAct(data) {
   return JSON.stringify(data, null, 2);
 }
 
-/**
- * Format ask response
- */
 function formatAsk(data) {
-  if (data.message) {
-    return data.message;
-  }
+  if (data.message) return data.message;
 
   const lines = [];
 
-  if (data.help_articles && data.help_articles.length > 0) {
+  if (data.help_articles?.length > 0) {
     lines.push('**Help Articles:**');
     for (const a of data.help_articles) {
       lines.push(`- **${a.title}**: ${a.content}`);
@@ -392,15 +427,15 @@ function formatAsk(data) {
     lines.push('');
   }
 
-  if (data.priorities && data.priorities.length > 0) {
+  if (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(`- ${p.theme} (${p.category}, ${p.volume} users) — \`${p.id}\``);
     }
     lines.push('');
   }
 
-  if (data.feedback && data.feedback.length > 0) {
+  if (data.feedback?.length > 0) {
     lines.push('**Related Feedback:**');
     for (const f of data.feedback) {
       lines.push(`- [${f.source}] "${f.text}"`);
@@ -415,7 +450,7 @@ function formatAsk(data) {
     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(`- Categories: ${cats}`);
     }
     lines.push('');
   }
@@ -424,45 +459,95 @@ function formatAsk(data) {
     return `No results found for "${data.question}". Try rephrasing.`;
   }
 
-  lines.push(`---\n${data.total} results found`);
+  lines.push(`---\n${data.total} results`);
+  return lines.join('\n');
+}
+
+// Internal helper: format weekly digest data (called from formatPriorities when weekly: true)
+function formatWeeklyDigest(data) {
+  if (data.error) return `Error: ${data.error}`;
+
+  const lines = [];
+
+  lines.push(`**${data.headline || 'Weekly Digest'}**\n`);
+
+  if (data.movements?.length > 0) {
+    lines.push('**Movements:**');
+    for (const m of data.movements) {
+      const arrow = m.direction === 'up' ? '↑' : '↓';
+      lines.push(`- ${arrow} ${m.title} (#${m.from_rank} → #${m.to_rank})`);
+    }
+    lines.push('');
+  }
+
+  if (data.new_entries?.length > 0) {
+    lines.push('**New This Week:**');
+    for (const n of data.new_entries) {
+      lines.push(`- ${n.title} (rank #${n.rank}, ${n.mentions} mentions)`);
+    }
+    lines.push('');
+  }
+
+  if (data.volume_spikes?.length > 0) {
+    lines.push('**Volume Spikes:**');
+    for (const v of data.volume_spikes) {
+      lines.push(`- ${v.title} (+${v.percent_increase}%)`);
+    }
+    lines.push('');
+  }
+
+  if (data.dropped?.length > 0) {
+    lines.push('**Dropped Off:**');
+    for (const d of data.dropped) {
+      lines.push(`- ${d.title}${d.reason ? ` (${d.reason})` : ''}`);
+    }
+    lines.push('');
+  }
+
+  if (!data.has_previous) {
+    lines.push('*First week — baseline captured. Changes will appear next week.*');
+  }
+
+  if (lines.length <= 1) {
+    return data.headline || 'No changes this week.';
+  }
 
   return lines.join('\n');
 }
 
-/**
- * Handle tool calls
- */
+// Internal helper: format batch export data (called from formatSpec when batch: true)
+function formatBatchExport(data) {
+  if (data.error) return `Error: ${data.error}${data.suggestion ? `\n${data.suggestion}` : ''}`;
+
+  let output = `**${data.count} brief${data.count !== 1 ? 's' : ''} exported**\n\n`;
+  output += data.markdown;
+  return output;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Tool Call Handler
+// ─────────────────────────────────────────────────────────────
+
 async function handleToolCall(id, params, token) {
   const { name, arguments: args } = params;
 
   try {
     const result = await callMcpApi(token, name, args || {});
 
-    let formattedText;
-
-    switch (name) {
-      case 'circuit.priorities':
-        formattedText = formatPriorities(result);
-        break;
-      case 'circuit.brief':
-        formattedText = formatBrief(result);
-        break;
-      case 'circuit.act':
-        formattedText = formatAct(result);
-        break;
-      case 'circuit.ask':
-        formattedText = formatAsk(result);
-        break;
-      default:
-        formattedText = JSON.stringify(result, null, 2);
-    }
+    const formatters = {
+      'circuit.priorities': formatPriorities,
+      'circuit.spec': formatSpec,
+      'circuit.act': formatAct,
+      'circuit.ask': formatAsk,
+    };
+
+    const formatter = formatters[name] || ((d) => JSON.stringify(d, null, 2));
+    const text = formatter(result);
 
     return {
       jsonrpc: '2.0',
       id,
-      result: {
-        content: [{ type: 'text', text: formattedText }]
-      }
+      result: { content: [{ type: 'text', text }] }
     };
 
   } catch (err) {