@ourroadmaps/mcp 0.7.2 → 0.7.5

package/dist/index.js

@@ -102,6 +102,7 @@ var featureSchema = z4.object({
   organizationId: z4.string(),
   type: featureTypeSchema,
   name: z4.string(),
+  description: z4.string().nullable(),
   parentId: z4.string().uuid().nullable(),
   order: z4.number().int(),
   isExpanded: z4.boolean(),
@@ -487,6 +488,13 @@ class ApiClient {
       method: "DELETE"
     });
   }
+  async reorderRoadmaps(items) {
+    const response = await this.request("/v1/roadmaps/reorder", {
+      method: "POST",
+      body: JSON.stringify({ items })
+    });
+    return response;
+  }
   async savePrd(roadmapId, data) {
     const response = await this.request(`/v1/roadmaps/${roadmapId}/prd`, {
       method: "POST",
@@ -521,11 +529,17 @@ class ApiClient {
       method: "DELETE"
     });
   }
-  async addFeatureOutcome(featureId, content) {
-    await this.request(`/v1/features/${featureId}/outcomes`, {
+  async saveFeatureOutcomes(featureId, outcomes) {
+    const response = await this.request(`/v1/features/${featureId}/outcomes`, {
       method: "POST",
-      body: JSON.stringify({ content })
+      body: JSON.stringify({
+        outcomes: outcomes.map((description, index) => ({
+          description,
+          order: index
+        }))
+      })
     });
+    return response.data;
   }
   async linkFeatureToRoadmap(featureId, roadmapId) {
     await this.request(`/v1/features/${featureId}/roadmap-items`, {
@@ -708,6 +722,7 @@ function registerAllTools(server) {
   registerCreateRoadmapItem(server);
   registerUpdateRoadmapItem(server);
   registerDeleteRoadmapItem(server);
+  registerReorderRoadmaps(server);
   registerAddFeature(server);
   registerUpdateFeature(server);
   registerDeleteFeature(server);
@@ -768,7 +783,10 @@ function registerSearchRoadmaps(server) {
             id: r.id,
             title: r.title,
             status: r.status,
-            horizon: r.horizon
+            horizon: r.horizon,
+            value: r.value,
+            effort: r.effort,
+            order: r.order
           })), null, 2)
         }
       ]
@@ -793,6 +811,9 @@ function registerGetRoadmap(server) {
             title: roadmap2.title,
             status: roadmap2.status,
             horizon: roadmap2.horizon,
+            value: roadmap2.value,
+            effort: roadmap2.effort,
+            order: roadmap2.order,
             prd: roadmap2.prd,
             brainstormNotes: roadmap2.brainstormNotes,
             wireframes: roadmap2.wireframes?.map((w) => ({
@@ -932,17 +953,19 @@ function registerGetContext(server) {
 - Products: What the organization builds (brands, products, apps, services) with hierarchy
 - Audiences: Who the product serves (stakeholders and user personas) with their preferences
 - Scenarios: User workflows and how they accomplish goals
+- Features: Capabilities and functionality areas organized hierarchically
 - Roadmap Summary: Count of items by status and horizon for planning overview
 
 Use this as your FIRST call when starting work on a roadmap to understand the full context.`,
     inputSchema: {}
   }, async () => {
     const client2 = getApiClient();
-    const [strategy, products, audiences, scenarios, roadmaps] = await Promise.all([
+    const [strategy, products, audiences, scenarios, features, roadmaps] = await Promise.all([
       client2.getStrategy(),
       client2.listProducts(),
       client2.listAudiences(),
       client2.listScenarios(),
+      client2.listFeatures(),
       client2.listRoadmaps()
     ]);
     const statusCounts = {};
@@ -983,6 +1006,12 @@ Use this as your FIRST call when starting work on a roadmap to understand the fu
               when: s.when,
               then: s.then
             })),
+            features: features.map((f) => ({
+              id: f.id,
+              name: f.name,
+              type: f.type,
+              parentId: f.parentId
+            })),
             roadmapSummary: {
               total: roadmaps.length,
               byStatus: statusCounts,
@@ -1070,20 +1099,27 @@ function registerCreateRoadmapItem(server) {
     };
   });
 }
+var effortSizeSchema = z10.enum(["xs", "s", "m", "l", "xl"]);
 function registerUpdateRoadmapItem(server) {
   server.registerTool("update_roadmap_item", {
-    description: "Update an existing roadmap item. Can update title, status, horizon, prompt, or brainstorm notes.",
+    description: "Update an existing roadmap item. Can update title, status, horizon, value, effort, order, prompt, or brainstorm notes.",
     inputSchema: {
       id: z10.string().describe("The UUID of the roadmap item to update"),
       title: z10.string().optional().describe("New title"),
       status: roadmapStatusSchema.optional().describe("New status"),
-      horizon: horizonSchema.optional().describe("New planning horizon")
+      horizon: horizonSchema.optional().describe("New planning horizon"),
+      value: z10.number().int().min(1).max(3).nullable().optional().describe("Value rating (1-3 stars, where 3 is highest value)"),
+      effort: effortSizeSchema.nullable().optional().describe("Effort estimate (xs=extra small, s=small, m=medium, l=large, xl=extra large)"),
+      order: z10.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)")
     }
   }, async ({
     id,
     title,
     status,
-    horizon
+    horizon,
+    value,
+    effort,
+    order
   }) => {
     const client2 = getApiClient();
     const updates = {};
@@ -1093,6 +1129,12 @@ function registerUpdateRoadmapItem(server) {
       updates.status = status;
     if (horizon !== undefined)
       updates.horizon = horizon;
+    if (value !== undefined)
+      updates.value = value;
+    if (effort !== undefined)
+      updates.effort = effort;
+    if (order !== undefined)
+      updates.order = order;
     const roadmap2 = await client2.updateRoadmap(id, updates);
     return {
       content: [
@@ -1104,7 +1146,10 @@ function registerUpdateRoadmapItem(server) {
               id: roadmap2.id,
               title: roadmap2.title,
               status: roadmap2.status,
-              horizon: roadmap2.horizon
+              horizon: roadmap2.horizon,
+              value: roadmap2.value,
+              effort: roadmap2.effort,
+              order: roadmap2.order
             }
           }, null, 2)
         }
@@ -1139,9 +1184,7 @@ function registerAddFeature(server) {
       parentId: parentId ?? null
     });
     if (outcomes && outcomes.length > 0) {
-      for (const outcome of outcomes) {
-        await client2.addFeatureOutcome(feature2.id, outcome);
-      }
+      await client2.saveFeatureOutcomes(feature2.id, outcomes);
     }
     if (linkToRoadmapId) {
       await client2.linkFeatureToRoadmap(feature2.id, linkToRoadmapId);
@@ -1259,6 +1302,32 @@ function registerDeleteRoadmapItem(server) {
     };
   });
 }
+function registerReorderRoadmaps(server) {
+  server.registerTool("reorder_roadmaps", {
+    description: "Bulk reorder roadmap items by setting their order values. Use this to prioritize and organize the roadmap. Lower order values appear first.",
+    inputSchema: {
+      items: z10.array(z10.object({
+        id: z10.string().describe("The UUID of the roadmap item"),
+        order: z10.number().int().min(0).describe("The new order value (0-based, lower = higher priority)")
+      })).describe("Array of roadmap items with their new order values")
+    }
+  }, async ({ items }) => {
+    const client2 = getApiClient();
+    const result = await client2.reorderRoadmaps(items);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: result.success,
+            message: `Successfully reordered ${items.length} roadmap items`,
+            itemsReordered: items.length
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
 function registerUpdateFeature(server) {
   server.registerTool("update_feature", {
     description: "Update an existing feature. Can update name, type, or parent.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ourroadmaps/mcp",
-  "version": "0.7.2",
+  "version": "0.7.5",
   "description": "MCP server for OurRoadmaps - manage roadmaps, features, and ideas from Claude Code",
   "type": "module",
   "bin": {