npm - circuit-mcp - Versions diffs - 1.0.8 → 1.0.10 - Mend

circuit-mcp 1.0.8 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/package.json CHANGED Viewed

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

package/src/auth.js CHANGED Viewed

@@ -148,39 +148,69 @@ function getSuccessPage() {
       justify-content: center;
       color: #1C1A18;
     }
-    .container {
+    .card {
+      background: white;
+      border-radius: 16px;
+      box-shadow: 0 4px 24px rgba(0,0,0,0.08);
+      padding: 48px 64px;
       text-align: center;
-      padding: 48px;
+      max-width: 420px;
     }
-    .icon {
-      font-size: 48px;
-      margin-bottom: 24px;
+    .logo {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      gap: 8px;
+      margin-bottom: 32px;
+    }
+    .logo-icon {
+      width: 28px;
+      height: 28px;
+      background: #1C1A18;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .logo-icon::after {
+      content: '';
+      width: 12px;
+      height: 12px;
+      border: 2px solid white;
+      border-radius: 50%;
+    }
+    .logo-text {
+      font-size: 16px;
+      font-weight: 500;
+    }
+    .woo {
+      font-size: 14px;
+      color: rgba(28,26,24,0.5);
+      margin-bottom: 8px;
     }
     h1 {
-      font-size: 24px;
+      font-size: 28px;
       font-weight: 600;
-      margin-bottom: 16px;
+      margin-bottom: 12px;
     }
     p {
-      font-size: 16px;
+      font-size: 15px;
       color: rgba(28,26,24,0.6);
-      margin-bottom: 8px;
-    }
-    .hint {
-      margin-top: 24px;
-      font-size: 14px;
-      color: rgba(28,26,24,0.4);
+      line-height: 1.5;
     }
   </style>
 </head>
 <body>
-  <div class="container">
-    <div class="icon">◉</div>
+  <div class="card">
+    <div class="logo">
+      <div class="logo-icon"></div>
+      <span class="logo-text">Circuit</span>
+    </div>
+    <p class="woo">Woo hoo!</p>
     <h1>Connected to Circuit</h1>
-    <p>You can close this window.</p>
-    <p class="hint">Return to your terminal to continue.</p>
+    <p>You can close this window to continue Circuiting.</p>
   </div>
-  <script>setTimeout(() => window.close(), 2000);</script>
+  <script>setTimeout(() => window.close(), 3000);</script>
 </body>
 </html>`;
 }

package/src/index.js CHANGED Viewed

@@ -129,6 +129,20 @@ function prompt(question) {
   });
 }
+function showUsageGuide() {
+  console.log(chalk.dim('  ─────────────────────────────────────────\n'));
+  console.log(chalk.white.bold('  How to use Circuit\n'));
+  console.log(chalk.dim('  Open Claude Code or Cursor and ask:\n'));
+  console.log(chalk.white('  "What are my top priorities?"'));
+  console.log(chalk.white('  "Show me the brief for priority #1"'));
+  console.log(chalk.white('  "What feedback mentions dark mode?"'));
+  console.log(chalk.white('  "What are my most urgent issues?"'));
+  console.log(chalk.white('  "Show priorities by revenue impact"'));
+  console.log();
+  console.log(chalk.dim('  Circuit will fetch your real customer data.'));
+  console.log(chalk.dim('  Just ask naturally and your AI will handle the rest.\n'));
+}
 // Configure Cursor by writing to ~/.cursor/mcp.json
 async function configureCursor() {
   const configPath = path.join(os.homedir(), '.cursor', 'mcp.json');
@@ -243,9 +257,28 @@ async function runSetup() {
   console.log(chalk.dim('  ─────────────────────────────────────────\n'));
   console.log(chalk.white.bold('  Almost done!\n'));
-  console.log(chalk.dim('  When you restart your editor, Circuit will'));
-  console.log(chalk.dim('  prompt you to sign in on first use.\n'));
-  console.log(chalk.dim('  That\'s it. You\'re all set.\n'));
+  console.log(chalk.dim('  Now let\'s connect your Circuit account.\n'));
+  const authChoice = await prompt(chalk.cyan('  Sign in now? (Y/n): '));
+  if (authChoice.toLowerCase() !== 'n') {
+    console.log();
+    console.log(chalk.dim('  Opening browser to sign in...\n'));
+    try {
+      const token = await authenticate();
+      showSuccess('Signed in to Circuit');
+      console.log();
+    } catch (err) {
+      showError('Could not sign in automatically.');
+      console.log(chalk.dim('     Run this later: npx circuit-mcp auth\n'));
+    }
+  }
+  console.log(chalk.dim('  ─────────────────────────────────────────\n'));
+  console.log(chalk.white.bold('  You\'re all set!\n'));
+  console.log(chalk.dim('  Restart your editor and start using Circuit.\n'));
+  showUsageGuide();
 }
 async function runAuth() {
@@ -258,6 +291,7 @@ async function runAuth() {
     spinner.stop();
     showSuccess('Authenticated successfully!');
     console.log(chalk.dim('\n  Your token is stored locally.\n'));
+    showUsageGuide();
   } catch (err) {
     spinner.stop();
     showError(`Authentication failed: ${err.message}`);

package/src/server.js CHANGED Viewed

@@ -35,6 +35,30 @@ export async function startMcpServer(token) {
   process.stdin.resume();
 }
+/**
+ * Call Circuit MCP backend API
+ */
+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
+    })
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`API error ${response.status}: ${text}`);
+  }
+  return response.json();
+}
 /**
  * Handle incoming MCP message
  */
@@ -71,47 +95,83 @@ async function handleMessage(message, token) {
           tools: [
             {
               name: 'get_priorities',
-              description: 'Get the top customer feedback priorities from Circuit',
+              description: 'Get your top priorities from Circuit, ranked by customer volume. These are the features/fixes that matter most to your users.',
               inputSchema: {
                 type: 'object',
                 properties: {
                   limit: {
                     type: 'number',
-                    description: 'Maximum number of priorities to return (default: 10)'
+                    description: 'Number of priorities to return (default: 5, max: 20)'
                   },
-                  focus: {
+                  sort_by: {
                     type: 'string',
-                    description: 'Focus type: volume, revenue, urgency, negative, positive, feature',
-                    enum: ['volume', 'revenue', 'urgency', 'negative', 'positive', 'feature']
+                    description: 'Sort criterion: volume, urgency, revenue, negative, positive',
+                    enum: ['volume', 'urgency', 'revenue', 'negative', 'positive']
                   }
                 }
               }
             },
             {
               name: 'get_brief',
-              description: 'Get the engineering brief for a specific priority',
+              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.',
               inputSchema: {
                 type: 'object',
                 properties: {
                   priority_id: {
                     type: 'string',
-                    description: 'The ID of the priority to get the brief for'
+                    description: 'The priority ID (from get_priorities)'
+                  },
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID directly (alternative to priority_id)'
+                  }
+                }
+              }
+            },
+            {
+              name: 'start_building',
+              description: "Mark a brief as 'building' - you're actively working on this feature.",
+              inputSchema: {
+                type: 'object',
+                properties: {
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID to mark as building'
+                  }
+                },
+                required: ['build_id']
+              }
+            },
+            {
+              name: 'mark_done',
+              description: "Mark a brief as 'done' - the feature has shipped! This closes the feedback loop.",
+              inputSchema: {
+                type: 'object',
+                properties: {
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID to mark as done'
                   }
                 },
-                required: ['priority_id']
+                required: ['build_id']
               }
             },
             {
-              name: 'get_feedback',
-              description: 'Get raw customer feedback items',
+              name: 'search_feedback',
+              description: 'Search customer feedback by keyword. Useful for understanding pain points around specific features.',
               inputSchema: {
                 type: 'object',
                 properties: {
+                  query: {
+                    type: 'string',
+                    description: 'Search query (keywords or phrase)'
+                  },
                   limit: {
                     type: 'number',
-                    description: 'Maximum number of feedback items to return (default: 20)'
+                    description: 'Max results (default: 10)'
                   }
-                }
+                },
+                required: ['query']
               }
             }
           ]
@@ -151,28 +211,8 @@ async function handleToolCall(id, params, token) {
   const { name, arguments: args } = params;
   try {
-    let result;
-    switch (name) {
-      case 'get_priorities':
-        result = await fetchPriorities(token, args);
-        break;
-      case 'get_brief':
-        result = await fetchBrief(token, args);
-        break;
-      case 'get_feedback':
-        result = await fetchFeedback(token, args);
-        break;
-      default:
-        return {
-          jsonrpc: '2.0',
-          id,
-          error: { code: -32602, message: `Unknown tool: ${name}` }
-        };
-    }
+    // Call the Circuit MCP backend
+    const result = await callMcpApi(token, name, args || {});
     return {
       jsonrpc: '2.0',
@@ -191,96 +231,3 @@ async function handleToolCall(id, params, token) {
   }
 }
-/**
- * Fetch priorities from Circuit API
- */
-async function fetchPriorities(token, args = {}) {
-  const limit = args.limit || 10;
-  const focus = args.focus || 'volume';
-  const url = `${CIRCUIT_API}/api/focus?limit=${limit}&focus_type=${focus}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  // Format for readability
-  return (data.priorities || data.clusters || []).map((p, i) => ({
-    rank: i + 1,
-    id: p.cluster_id || p.id,
-    title: p.summary || p.theme,
-    category: p.category,
-    mentions: p.volume || p.count,
-    urgency: p.urgency_score,
-    trend: p.trend
-  }));
-}
-/**
- * Fetch a specific brief from Circuit API
- */
-async function fetchBrief(token, args) {
-  if (!args.priority_id) {
-    throw new Error('priority_id is required');
-  }
-  const url = `${CIRCUIT_API}/api/builds?cluster_id=${args.priority_id}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  const build = (data.builds || []).find(b =>
-    b.cluster_id === args.priority_id || b.clusterId === args.priority_id
-  );
-  if (!build) {
-    throw new Error('Brief not found for this priority');
-  }
-  return {
-    id: build.id,
-    title: build.title,
-    status: build.status,
-    content: build.build || build.spec_content
-  };
-}
-/**
- * Fetch raw feedback from Circuit API
- */
-async function fetchFeedback(token, args = {}) {
-  const limit = args.limit || 20;
-  const url = `${CIRCUIT_API}/api/feedback/all?limit=${limit}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  return (data.feedback || []).map(f => ({
-    id: f.id,
-    text: f.text,
-    source: f.source,
-    sentiment: f.analysis?.sentiment,
-    intent: f.analysis?.intent,
-    created_at: f.created_at
-  }));
-}