@loupekit/mcp 0.10.7-next.52 → 0.10.8-next.53

package/README.md

@@ -51,10 +51,10 @@ element, its state, and the page.
 
 | Tool | Description |
 | --- | --- |
-| `list_comments(status?, url?)` | List comments, optionally filtered by status (`open` / `in_progress` / `done`) or page URL. |
+| `list_comments(status?, url?)` | List comments, optionally filtered by stage (`queue` / `todo` / `in_progress` / `in_review` / `resolved`) or page URL. The legacy names `open` / `done` are accepted too. |
 | `get_comment(id)` | The full Claude-ready package for one comment: request + element HTML + computed styles + the **screenshot as an image** + any screen-recording URL. |
 | `propose_change(id, html, css?, notes?)` | Write your **modified HTML/CSS** back onto the comment. The dashboard renders it as code plus a live before/after preview for the dev team. |
-| `update_status(id, status)` | Move a comment across the workflow (`open` → `in_progress` → `done`) so triage state stays in sync. |
+| `update_status(id, status)` | Move a comment along the board (`queue` → `todo` → `in_progress` → `in_review` → `resolved`) so triage state stays in sync. Move to `in_review` when a change is ready — only a person resolves. |
 
 ## Install
 

package/dist/index.js

@@ -8,6 +8,8 @@ import { realpathSync } from "fs";
 import { argv } from "process";
 import { z } from "zod";
 import { Buffer } from "buffer";
+import { COMMENT_STAGES, normalizeStatus, STAGE_LABELS } from "@loupekit/shared";
+var STAGE_ARG = z.string().describe(`Stage: ${COMMENT_STAGES.join(" / ")}. Legacy "open" and "done" are accepted too.`);
 var API = (process.env.LOUPE_API || "http://localhost:8787").replace(/\/$/, "");
 var PROJECT_KEY = process.env.LOUPE_PROJECT_KEY || "pk_demo_acme";
 var ADMIN = process.env.LOUPE_ADMIN_KEY || "";
@@ -54,10 +56,13 @@ async function listComments({ status, url }) {
   const q = new URLSearchParams({ projectKey: PROJECT_KEY });
   if (url) q.set("url", url);
   let comments = await api(`/v1/comments?${q}`);
-  if (status) comments = comments.filter((c) => c.status === status);
+  if (status) {
+    const want = normalizeStatus(status);
+    comments = comments.filter((c) => normalizeStatus(c.status) === want);
+  }
   if (!comments.length) return wrap("No comments match.");
   const lines = comments.map(
-    (c) => `- [${c.status}] #${c.id} \u2014 ${titleOf(c)}: ${c.body}
+    (c) => `- [${STAGE_LABELS[normalizeStatus(c.status)]}] #${c.id} \u2014 ${titleOf(c)}: ${c.body}
     \u21B3 ${targetOf(c)} on ${c.url} (by ${c.author.name})`
   );
   return wrap(`${comments.length} comment(s):
@@ -70,7 +75,7 @@ async function getComment({ id }) {
   const c = await api(`/v1/comments/${encodeURIComponent(id)}`);
   if (c.kind === "free") {
     const text2 = [
-      `# Feedback #${c.id} from ${c.author.name} (${c.status})`,
+      `# Feedback #${c.id} from ${c.author.name} (${STAGE_LABELS[normalizeStatus(c.status)]})`,
       ``,
       `**Title:** ${titleOf(c)}`,
       `**Note:** ${c.body}`,
@@ -82,7 +87,7 @@ async function getComment({ id }) {
     return wrap(text2, ...imgs.map((i) => ({ type: "image", data: i.data, mimeType: i.mimeType })));
   }
   const text = [
-    `# Feedback #${c.id} from ${c.author.name} (${c.status})`,
+    `# Feedback #${c.id} from ${c.author.name} (${STAGE_LABELS[normalizeStatus(c.status)]})`,
     ``,
     `**Title:** ${titleOf(c)}`,
     `**Request:** ${c.body}`,
@@ -122,8 +127,9 @@ async function getComment({ id }) {
   return wrap(text, ...images.map((i) => ({ type: "image", data: i.data, mimeType: i.mimeType })));
 }
 async function updateStatus({ id, status }) {
-  await api(`/v1/comments/${encodeURIComponent(id)}`, { method: "PATCH", body: JSON.stringify({ status }) });
-  return wrap(`#${id} \u2192 ${status}`);
+  const stage = normalizeStatus(status);
+  await api(`/v1/comments/${encodeURIComponent(id)}`, { method: "PATCH", body: JSON.stringify({ status: stage }) });
+  return wrap(`#${id} \u2192 ${STAGE_LABELS[stage]}`);
 }
 async function proposeChange({ id, html, css, notes }) {
   const proposal = {
@@ -136,12 +142,12 @@ async function proposeChange({ id, html, css, notes }) {
   await api(`/v1/comments/${encodeURIComponent(id)}`, { method: "PATCH", body: JSON.stringify({ proposal }) });
   return wrap(`Proposal saved for #${id}. The dev team can now review your modified HTML/CSS in the dashboard.`);
 }
-var server = new McpServer({ name: "loupe", version: "0.10.7" });
+var server = new McpServer({ name: "loupe", version: "0.10.8" });
 server.tool(
   "list_comments",
   "List Loupe product-feedback comments for the project as a task backlog. Use this to see what a PM has flagged, then work through the items.",
   {
-    status: z.enum(["open", "in_progress", "done"]).optional().describe("Filter by status. Omit for all."),
+    status: STAGE_ARG.optional().describe(`Filter by stage. Omit for all.`),
     url: z.string().optional().describe("Filter to a single page path, e.g. /checkout.")
   },
   listComments
@@ -154,8 +160,8 @@ server.tool(
 );
 server.tool(
   "update_status",
-  "Update a comment's status. Set to in_progress when you start it and done when the change is shipped \u2014 this closes the loop back to the PM.",
-  { id: z.string(), status: z.enum(["open", "in_progress", "done"]) },
+  "Move a comment along the board. Set In Progress when you start it, and In Review when the change is ready for a human \u2014 only a person resolves a comment, so never set Resolved yourself.",
+  { id: z.string(), status: STAGE_ARG },
   updateStatus
 );
 server.tool(

package/package.json

@@ -5,7 +5,7 @@
     "email": "m.ashraf.saed@gmail.com",
     "url": "https://www.linkedin.com/in/mohamedashrafelsaed/"
   },
-  "version": "0.10.7-next.52",
+  "version": "0.10.8-next.53",
   "description": "MCP server that exposes Loupe comments to Claude Code as an actionable, fully-contextualized backlog.",
   "keywords": [
     "loupe",
@@ -46,6 +46,6 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@loupekit/shared": "0.10.7-next.52"
+    "@loupekit/shared": "0.10.8-next.53"
   }
 }