@vibesharingapp/mcp-server 0.4.2 → 0.6.0

package/dist/index.js

@@ -59,8 +59,39 @@ class VibesharingClient {
     async getPrototype(id) {
         return this.request(`/api/prototypes/${id}`);
     }
-    async getFeedback(projectId) {
-        return this.request(`/api/feedback?projectId=${projectId}`);
+    async getFeedback(projectId, filters) {
+        const params = new URLSearchParams({ projectId });
+        if (filters?.status)
+            params.set("status", filters.status);
+        if (filters?.priority)
+            params.set("priority", filters.priority);
+        if (filters?.assigned_to)
+            params.set("assignedTo", filters.assigned_to);
+        return this.request(`/api/feedback?${params.toString()}`);
+    }
+    async triageFeedback(feedbackIds, updates) {
+        if (feedbackIds.length === 1) {
+            return this.request("/api/feedback", {
+                method: "PATCH",
+                body: JSON.stringify({
+                    feedbackId: feedbackIds[0],
+                    status: updates.status,
+                    priority: updates.priority,
+                    assignedTo: updates.assigned_to,
+                    resolutionNote: updates.resolution_note,
+                }),
+            });
+        }
+        return this.request("/api/feedback/bulk", {
+            method: "PATCH",
+            body: JSON.stringify({
+                feedbackIds,
+                status: updates.status,
+                priority: updates.priority,
+                assignedTo: updates.assigned_to,
+                resolutionNote: updates.resolution_note,
+            }),
+        });
     }
     async syncContext(projectId, content) {
         return this.request("/api/context", {
@@ -133,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:
@@ -178,20 +234,31 @@ function fuzzyMatch(query, items, getName, threshold = 0.3) {
         .sort((a, b) => b.score - a.score);
 }
 // ---- Version tracking & What's New ----
-const CURRENT_VERSION = "0.4.2";
+const CURRENT_VERSION = "0.6.0";
 const WHATS_NEW = {
-    "0.4.0": [
-        "🆕 VibeSharing MCP v0.4.0 — What's 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:",
         "",
-        "• resolve_target tool — Call this before deploying to confirm the collection,",
-        "  project name, and deploy URL with the user. Fuzzy-matches names so you don't",
-        "  need exact IDs.",
-        "• Named deployments — Use deploy_name on import_repo or deploy_files to set a",
-        "  friendly Vercel URL (e.g., 'erg-v3-teams' → erg-v3-teams.vercel.app).",
-        "• Fuzzy search — list_collections and list_prototypes now accept a 'search'",
-        "  parameter to filter results.",
-        "• Guardrails — Deploy tools now ask for confirmation when collection or project",
-        "  info is missing, instead of auto-generating everything silently.",
+        "• Feedback triage — get_feedback now supports status, priority, and assignee",
+        "  filters. Use triage_feedback to update status (open/in_progress/resolved/",
+        "  wont_fix/deferred), set priority, and assign feedback to team members.",
+        "• New tool: triage_feedback — Bulk update feedback items without leaving your editor.",
+    ].join("\n"),
+    "0.4.0": [
+        "• resolve_target tool — Fuzzy-matches collection/project names.",
+        "• Named deployments — Set friendly Vercel URLs with deploy_name.",
+        "• Fuzzy search on list_collections and list_prototypes.",
+        "• Guardrails on deploy tools.",
     ].join("\n"),
 };
 function getWhatsNew() {
@@ -242,7 +309,7 @@ const client = new VibesharingClient(VIBESHARING_URL, VIBESHARING_TOKEN);
 // Create MCP server
 const server = new index_js_1.Server({
     name: "vibesharing",
-    version: "0.4.0",
+    version: "0.6.0",
 }, {
     capabilities: {
         tools: {},
@@ -319,7 +386,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
             },
             {
                 name: "get_feedback",
-                description: "Get feedback and comments for a specific prototype. Use this to see what the team thinks about a prototype.",
+                description: "Get feedback and comments for a specific prototype. Can filter by status (open, in_progress, resolved, wont_fix, deferred), priority (critical, high, medium, low), or assignee.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -327,10 +394,96 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "The VibeSharing project/prototype ID",
                         },
+                        status: {
+                            type: "string",
+                            description: "Filter by status: open, in_progress, resolved, wont_fix, deferred. Comma-separated for multiple.",
+                        },
+                        priority: {
+                            type: "string",
+                            description: "Filter by priority: critical, high, medium, low",
+                        },
+                        assigned_to: {
+                            type: "string",
+                            description: "Filter by assignee user ID, or 'unassigned' for unassigned feedback",
+                        },
                     },
                     required: ["project_id"],
                 },
             },
+            {
+                name: "triage_feedback",
+                description: "Update status, priority, or assignee on one or more feedback items. Use this to triage feedback from within your editor.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        feedback_ids: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "One or more feedback IDs to update",
+                        },
+                        status: {
+                            type: "string",
+                            enum: ["open", "in_progress", "resolved", "wont_fix", "deferred"],
+                            description: "New status for the feedback items",
+                        },
+                        priority: {
+                            type: "string",
+                            enum: ["critical", "high", "medium", "low"],
+                            description: "New priority for the feedback items. Omit to leave unchanged.",
+                        },
+                        assigned_to: {
+                            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.",
@@ -583,6 +736,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"],
+                },
+            },
         ],
     };
 });
@@ -716,26 +915,35 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     };
                 }
                 case "get_feedback": {
-                    const { project_id } = args;
-                    const result = await client.getFeedback(project_id);
+                    const { project_id, status: statusFilter, priority: priorityFilter, assigned_to: assignedToFilter } = args;
+                    const result = await client.getFeedback(project_id, {
+                        status: statusFilter,
+                        priority: priorityFilter,
+                        assigned_to: assignedToFilter,
+                    });
                     const feedback = result.feedback || [];
                     if (feedback.length === 0) {
+                        const filterNote = statusFilter || priorityFilter || assignedToFilter
+                            ? " matching your filters"
+                            : "";
                         return {
                             content: [
                                 {
                                     type: "text",
-                                    text: "No feedback yet for this prototype. Share it with your team to get their thoughts!",
+                                    text: `No feedback${filterNote} for this prototype. Share it with your team to get their thoughts!`,
                                 },
                             ],
                         };
                     }
                     const feedbackList = feedback
                         .map((f) => {
-                        const status = f.resolved_at ? " [Resolved]" : "";
+                        const itemStatus = f.status || (f.resolved_at ? "resolved" : "open");
+                        const priorityLabel = f.priority ? ` [${f.priority.toUpperCase()}]` : "";
+                        const assigneeLabel = f.assignee_name ? ` → ${f.assignee_name}` : "";
                         const replies = f.replies && f.replies.length > 0
                             ? `\n  Replies: ${f.replies.length}`
                             : "";
-                        return `- ${f.user_name}${status}: "${f.content}"\n  ${new Date(f.created_at).toLocaleDateString()}${replies}`;
+                        return `- [${itemStatus}]${priorityLabel}${assigneeLabel} ${f.user_name}: "${f.content}"\n  ID: ${f.id}\n  ${new Date(f.created_at).toLocaleDateString()}${replies}`;
                     })
                         .join("\n\n");
                     return {
@@ -747,6 +955,98 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         ],
                     };
                 }
+                case "triage_feedback": {
+                    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" }],
+                        };
+                    }
+                    const updates = {};
+                    if (newStatus)
+                        updates.status = newStatus;
+                    if (newPriority !== undefined)
+                        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)
+                        changes.push(`status → ${newStatus}`);
+                    if (newPriority)
+                        changes.push(`priority → ${newPriority}`);
+                    if (newAssignee !== undefined)
+                        changes.push(newAssignee ? `assigned → ${newAssignee}` : "unassigned");
+                    if (resolution_note)
+                        changes.push(`note: "${resolution_note}"`);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Updated ${feedback_ids.length} feedback item(s): ${changes.join(", ")}`,
+                            },
+                        ],
+                    };
+                }
+                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);
@@ -1173,6 +1473,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.4.2",
+  "version": "0.6.0",
   "description": "MCP server for VibeSharing - register prototypes and get feedback directly from Claude Code",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",