@vibesharingapp/mcp-server 0.5.0 → 0.6.1

package/README.md

@@ -73,11 +73,13 @@ Sign up at [vibesharing.app](https://vibesharing.app), then go to [Account Setti
 ### 2. Configure Claude Code
 
 ```bash
-claude mcp add vibesharing \
-  -e VIBESHARING_TOKEN=vs_your_token_here \
+claude mcp add vibesharing -s user \
+  -e VIBESHARING_TOKEN=vs_PASTE_YOUR_TOKEN \
   -- npx -y @vibesharingapp/mcp-server@latest
 ```
 
+> **Important:** Replace `vs_PASTE_YOUR_TOKEN` with your actual token. Use `-s user` so it works in all projects. Then restart Claude Code.
+
 Or add to your Claude Code settings manually:
 
 ```json
@@ -199,7 +201,9 @@ VibeSharing isn't just another tool to check. It's infrastructure for teams buil
 **Stop building in isolation. Start shipping with your team.**
 
 ```bash
-claude mcp add vibesharing \
-  -e VIBESHARING_TOKEN=vs_your_token_here \
+claude mcp add vibesharing -s user \
+  -e VIBESHARING_TOKEN=vs_PASTE_YOUR_TOKEN \
   -- npx -y @vibesharingapp/mcp-server@latest
 ```
+
+> **Important:** Replace `vs_PASTE_YOUR_TOKEN` with your actual token. Use `-s user` so it works in all projects. Then restart Claude Code.

package/dist/index.js

@@ -78,6 +78,7 @@ class VibesharingClient {
                     status: updates.status,
                     priority: updates.priority,
                     assignedTo: updates.assigned_to,
+                    resolutionNote: updates.resolution_note,
                 }),
             });
         }
@@ -88,6 +89,7 @@ class VibesharingClient {
                 status: updates.status,
                 priority: updates.priority,
                 assignedTo: updates.assigned_to,
+                resolutionNote: updates.resolution_note,
             }),
         });
     }
@@ -162,6 +164,31 @@ class VibesharingClient {
             method: "DELETE",
         });
     }
+    async generateFeedbackTopics(projectId, topics) {
+        return this.request("/api/feedback-topics", {
+            method: "POST",
+            body: JSON.stringify({
+                projectId,
+                topics,
+                source: "auto",
+            }),
+        });
+    }
+    async notifyFeedbackResolved(projectId, feedbackIds, deployUrl) {
+        return this.request("/api/feedback/notify-resolved", {
+            method: "POST",
+            body: JSON.stringify({ projectId, feedbackIds, deployUrl }),
+        });
+    }
+    async updateFeedbackBrief(projectId, brief, focus) {
+        const updates = { feedback_brief: brief };
+        if (focus)
+            updates.feedback_focus = focus;
+        return this.request(`/api/prototypes/${projectId}`, {
+            method: "PATCH",
+            body: JSON.stringify(updates),
+        });
+    }
 }
 /**
  * Simple fuzzy text matching. Scores based on:
@@ -207,8 +234,18 @@ function fuzzyMatch(query, items, getName, threshold = 0.3) {
         .sort((a, b) => b.score - a.score);
 }
 // ---- Version tracking & What's New ----
-const CURRENT_VERSION = "0.5.0";
+const CURRENT_VERSION = "0.6.0";
 const WHATS_NEW = {
+    "0.6.0": [
+        "🆕 VibeSharing MCP v0.6.0 — What's New:",
+        "",
+        "• Auto-generated feedback questions — After deploying, use generate_feedback_topics",
+        "  to create 3-5 targeted questions that guide stakeholders toward useful feedback.",
+        "  Questions are categorized by theme: vision alignment, feasibility, design fidelity,",
+        "  or interaction design. Previous auto-generated questions are replaced on each deploy.",
+        "• Feedback briefs — Include a brief parameter to set context stakeholders see in the",
+        "  Context tab. Also auto-extracted from ## Feedback Brief in CLAUDE.md at deploy time.",
+    ].join("\n"),
     "0.5.0": [
         "🆕 VibeSharing MCP v0.5.0 — What's New:",
         "",
@@ -266,13 +303,25 @@ const VIBESHARING_TOKEN = process.env.VIBESHARING_TOKEN;
 if (!VIBESHARING_TOKEN) {
     console.error("Error: VIBESHARING_TOKEN environment variable is required");
     console.error("Get your deploy token from VibeSharing → Account Settings");
+    console.error("");
+    console.error("Quick setup:");
+    console.error("  claude mcp add vibesharing -s user -e VIBESHARING_TOKEN=vs_YOUR_TOKEN -- npx -y @vibesharingapp/mcp-server@latest");
+    process.exit(1);
+}
+if (VIBESHARING_TOKEN === "vs_your_token_here" || VIBESHARING_TOKEN.length < 10) {
+    console.error("Error: VIBESHARING_TOKEN is still the placeholder value");
+    console.error("Replace it with your actual deploy token from VibeSharing → Account Settings");
+    console.error("");
+    console.error("Fix:");
+    console.error("  claude mcp remove vibesharing");
+    console.error("  claude mcp add vibesharing -s user -e VIBESHARING_TOKEN=vs_YOUR_TOKEN -- npx -y @vibesharingapp/mcp-server@latest");
     process.exit(1);
 }
 const client = new VibesharingClient(VIBESHARING_URL, VIBESHARING_TOKEN);
 // Create MCP server
 const server = new index_js_1.Server({
     name: "vibesharing",
-    version: "0.5.0",
+    version: "0.6.1",
 }, {
     capabilities: {
         tools: {},
@@ -398,10 +447,55 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "User ID to assign to. Use empty string to unassign.",
                         },
+                        resolution_note: {
+                            type: "string",
+                            description: "Brief explanation of how the feedback was addressed (shown to the stakeholder). Only meaningful when status is resolved/wont_fix/deferred.",
+                        },
                     },
                     required: ["feedback_ids"],
                 },
             },
+            {
+                name: "close_feedback_loop",
+                description: "CALL THIS AFTER DEPLOYING when there is open feedback. Matches what you just built to open feedback items, resolves them with explanations, and notifies the original stakeholders with a personalized digest. The stakeholder sees exactly what happened to their feedback.\n\nFlow:\n1. Pull open feedback via get_feedback\n2. Look at what you built and match changes to feedback items\n3. Call this tool with the resolutions\n4. Stakeholders get email: 'Your feedback was addressed' with per-item explanations",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The VibeSharing prototype ID",
+                        },
+                        resolutions: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    feedback_id: {
+                                        type: "string",
+                                        description: "The feedback item ID being resolved",
+                                    },
+                                    status: {
+                                        type: "string",
+                                        enum: ["resolved", "wont_fix", "deferred", "in_progress"],
+                                        description: "What happened: resolved (fixed), wont_fix (intentional), deferred (later), in_progress (started but not done)",
+                                    },
+                                    note: {
+                                        type: "string",
+                                        description: "Brief explanation of what changed or why it was deferred. This is shown directly to the stakeholder. Be specific: 'Nav restructured to separate admin and user flows' not 'Fixed the navigation'.",
+                                    },
+                                },
+                                required: ["feedback_id", "status", "note"],
+                            },
+                            description: "Array of feedback items to resolve with explanations",
+                        },
+                        deploy_url: {
+                            type: "string",
+                            description: "Optional: URL of the new deploy (included in notification so stakeholders can see the update)",
+                        },
+                    },
+                    required: ["project_id", "resolutions"],
+                },
+            },
             {
                 name: "sync_context",
                 description: "Sync your CLAUDE.md, AGENTS.md, or project context to VibeSharing. This helps maintain context across AI sessions and team members.",
@@ -654,6 +748,52 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                     required: ["link_id"],
                 },
             },
+            {
+                name: "generate_feedback_topics",
+                description: "Auto-generate feedback questions for a prototype based on what was built. IMPORTANT: Before generating questions, ask the user: 'What type of feedback is most important for this deploy?' and present these options:\n\n  1. Awareness only — just sharing progress, no feedback needed\n  2. Design direction — brand, visual, layout feedback\n  3. Technical feasibility — is this buildable, are these features doable\n  4. Vision alignment — does this match where we're going\n  5. Interaction design — usability, flow, UX patterns\n  6. Full review — all feedback welcome (default)\n\nUse their answer as the 'focus' parameter. If 'awareness', skip topic generation and just set the brief. Otherwise generate 3-5 questions, weighting toward the chosen focus theme.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        project_id: {
+                            type: "string",
+                            description: "The VibeSharing prototype ID",
+                        },
+                        focus: {
+                            type: "string",
+                            enum: ["awareness", "design", "feasibility", "vision", "interaction", "full"],
+                            description: "The type of feedback the designer wants. 'awareness' = no questions, just FYI. Others emphasize that theme. 'full' = all themes equally. Default: 'full'.",
+                        },
+                        brief: {
+                            type: "string",
+                            description: "A short (2-4 sentence) feedback brief explaining what this prototype is and what's ready for review. Stored on the prototype and shown to stakeholders in the Context tab.",
+                        },
+                        topics: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    title: {
+                                        type: "string",
+                                        description: "The feedback question (e.g., 'Does this navigation flow match how your team actually works?')",
+                                    },
+                                    description: {
+                                        type: "string",
+                                        description: "Optional: Additional context for the question",
+                                    },
+                                    theme: {
+                                        type: "string",
+                                        enum: ["vision", "feasibility", "design", "interaction"],
+                                        description: "Question theme: 'vision' (alignment with goals), 'feasibility' (technical possibility), 'design' (brand/visual fidelity), 'interaction' (usability/UX patterns)",
+                                    },
+                                },
+                                required: ["title"],
+                            },
+                            description: "Array of feedback questions to create. Generate 3-5 based on what you built. Weight toward the focus theme (e.g., if focus is 'feasibility', 2-3 questions should be feasibility-themed). Not required when focus is 'awareness'.",
+                        },
+                    },
+                    required: ["project_id"],
+                },
+            },
         ],
     };
 });
@@ -828,7 +968,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     };
                 }
                 case "triage_feedback": {
-                    const { feedback_ids, status: newStatus, priority: newPriority, assigned_to: newAssignee } = args;
+                    const { feedback_ids, status: newStatus, priority: newPriority, assigned_to: newAssignee, resolution_note } = args;
                     if (!feedback_ids || feedback_ids.length === 0) {
                         return {
                             content: [{ type: "text", text: "Error: feedback_ids array is required" }],
@@ -841,6 +981,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         updates.priority = newPriority;
                     if (newAssignee !== undefined)
                         updates.assigned_to = newAssignee || null;
+                    if (resolution_note)
+                        updates.resolution_note = resolution_note;
                     const result = await client.triageFeedback(feedback_ids, updates);
                     const changes = [];
                     if (newStatus)
@@ -849,6 +991,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         changes.push(`priority → ${newPriority}`);
                     if (newAssignee !== undefined)
                         changes.push(newAssignee ? `assigned → ${newAssignee}` : "unassigned");
+                    if (resolution_note)
+                        changes.push(`note: "${resolution_note}"`);
                     return {
                         content: [
                             {
@@ -858,6 +1002,63 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         ],
                     };
                 }
+                case "close_feedback_loop": {
+                    const { project_id, resolutions, deploy_url } = args;
+                    if (!resolutions || resolutions.length === 0) {
+                        return {
+                            content: [{ type: "text", text: "Error: At least one resolution is required." }],
+                        };
+                    }
+                    // Step 1: Resolve each feedback item with its note
+                    const resolvedIds = [];
+                    const errors = [];
+                    for (const res of resolutions) {
+                        try {
+                            await client.triageFeedback([res.feedback_id], {
+                                status: res.status,
+                                resolution_note: res.note,
+                            });
+                            resolvedIds.push(res.feedback_id);
+                        }
+                        catch (err) {
+                            errors.push(`Failed to update ${res.feedback_id}: ${err}`);
+                        }
+                    }
+                    // Step 2: Notify stakeholders
+                    let notifyResult = { notified: 0, emailed: 0, stakeholders: 0 };
+                    if (resolvedIds.length > 0) {
+                        try {
+                            notifyResult = await client.notifyFeedbackResolved(project_id, resolvedIds, deploy_url);
+                        }
+                        catch (err) {
+                            errors.push(`Notification failed: ${err}`);
+                        }
+                    }
+                    const statusLabels = {
+                        resolved: "Resolved",
+                        wont_fix: "Won't fix",
+                        deferred: "Deferred",
+                        in_progress: "In progress",
+                    };
+                    const lines = [
+                        `✅ Feedback loop closed — ${resolvedIds.length} item${resolvedIds.length === 1 ? "" : "s"} updated:`,
+                        "",
+                        ...resolutions.map((r, i) => {
+                            const label = statusLabels[r.status] || r.status;
+                            const success = resolvedIds.includes(r.feedback_id) ? "✓" : "✗";
+                            return `  ${success} [${label}] ${r.note}`;
+                        }),
+                    ];
+                    if (notifyResult.stakeholders > 0) {
+                        lines.push("", `📬 ${notifyResult.stakeholders} stakeholder${notifyResult.stakeholders === 1 ? "" : "s"} notified (${notifyResult.emailed} email${notifyResult.emailed === 1 ? "" : "s"} sent)`, "Each stakeholder received a personalized digest showing what happened to their specific feedback.");
+                    }
+                    if (errors.length > 0) {
+                        lines.push("", `⚠️ ${errors.length} error(s):`, ...errors.map(e => `  - ${e}`));
+                    }
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                    };
+                }
                 case "sync_context": {
                     const { project_id, content } = args;
                     await client.syncContext(project_id, content);
@@ -1284,6 +1485,85 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         ],
                     };
                 }
+                case "generate_feedback_topics": {
+                    const { project_id, topics, brief, focus } = args;
+                    const feedbackFocus = focus || "full";
+                    const themeLabels = {
+                        vision: "Vision Alignment",
+                        feasibility: "Feasibility",
+                        design: "Design Fidelity",
+                        interaction: "Interaction Design",
+                    };
+                    const focusLabels = {
+                        awareness: "Awareness only",
+                        design: "Design direction",
+                        feasibility: "Technical feasibility",
+                        vision: "Vision alignment",
+                        interaction: "Interaction design",
+                        full: "Full review",
+                    };
+                    // Store brief and focus
+                    try {
+                        await client.updateFeedbackBrief(project_id, brief || "", feedbackFocus);
+                    }
+                    catch (err) {
+                        console.error("Failed to store feedback brief/focus:", err);
+                    }
+                    // Awareness mode: no questions, just the brief
+                    if (feedbackFocus === "awareness") {
+                        // Clear any existing auto-generated questions
+                        try {
+                            await client.generateFeedbackTopics(project_id, []);
+                        }
+                        catch {
+                            // OK if this fails — just means no old auto topics to clear
+                        }
+                        const lines = [
+                            `📢 Prototype set to awareness mode — no feedback questions will be shown.`,
+                        ];
+                        if (brief) {
+                            lines.push("", `📋 Brief saved: "${brief.substring(0, 100)}${brief.length > 100 ? "..." : ""}"`);
+                        }
+                        lines.push("", "Stakeholders will see this as an FYI with the Context tab available.", "They can still leave general comments if they choose to.");
+                        return {
+                            content: [{ type: "text", text: lines.join("\n") }],
+                        };
+                    }
+                    // All other modes: generate questions
+                    if (!topics || topics.length === 0) {
+                        return {
+                            content: [{ type: "text", text: "Error: At least one topic is required when focus is not 'awareness'." }],
+                        };
+                    }
+                    // Sort topics: focused theme first, then others
+                    const sortedTopics = feedbackFocus !== "full"
+                        ? [
+                            ...topics.filter(t => t.theme === feedbackFocus),
+                            ...topics.filter(t => t.theme !== feedbackFocus),
+                        ]
+                        : topics;
+                    const result = await client.generateFeedbackTopics(project_id, sortedTopics);
+                    const created = result.topics || [];
+                    const lines = [
+                        `✅ Created ${created.length} feedback question${created.length === 1 ? "" : "s"} (focus: ${focusLabels[feedbackFocus] || feedbackFocus}):`,
+                        "",
+                        ...created.map((t, i) => {
+                            const tag = t.theme ? ` [${themeLabels[t.theme] || t.theme}]` : "";
+                            const star = t.theme === feedbackFocus ? " ★" : "";
+                            return `  ${i + 1}. ${t.title}${tag}${star}`;
+                        }),
+                    ];
+                    if (brief) {
+                        lines.push("", `📋 Feedback brief saved — stakeholders can see it in the Context tab.`);
+                    }
+                    if (feedbackFocus !== "full") {
+                        lines.push("", `${themeLabels[feedbackFocus] || feedbackFocus} questions are pinned to the top for stakeholders.`);
+                    }
+                    lines.push("", "Previous auto-generated questions were replaced. Manual questions are untouched.");
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                    };
+                }
                 default:
                     return {
                         content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibesharingapp/mcp-server",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "MCP server for VibeSharing - register prototypes and get feedback directly from Claude Code",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",