@ourroadmaps/mcp 0.8.0 → 0.10.0

package/dist/index.js

@@ -380,6 +380,23 @@ var featureLinkSchema = z8.object({
   }),
   createdAt: z8.string()
 });
+var phaseDesignSchema = z8.object({
+  id: z8.string().uuid(),
+  description: z8.string().nullable()
+});
+var phasePlanSchema = z8.object({
+  id: z8.string().uuid(),
+  description: z8.string().nullable()
+});
+var phaseBuildSchema = z8.object({
+  id: z8.string().uuid(),
+  description: z8.string().nullable(),
+  prompt: z8.string().nullable()
+});
+var phaseReleaseSchema = z8.object({
+  id: z8.string().uuid(),
+  description: z8.string().nullable()
+});
 var roadmapDetailSchema = roadmapSchema.extend({
   prd: prdSchema.nullable(),
   wireframes: z8.array(wireframeSchema),
@@ -387,7 +404,11 @@ var roadmapDetailSchema = roadmapSchema.extend({
   brainstormNotes: z8.string().nullable(),
   featureLinks: z8.array(featureLinkSchema),
   epics: z8.array(epicWithStoriesSchema),
-  stories: z8.array(storySchema)
+  stories: z8.array(storySchema),
+  design: phaseDesignSchema.nullable(),
+  plan: phasePlanSchema.nullable(),
+  build: phaseBuildSchema.nullable(),
+  release: phaseReleaseSchema.nullable()
 });
 var roadmapListSchema = z8.array(roadmapSchema);
 // ../../packages/shared/src/schemas/scenario.ts
@@ -454,7 +475,8 @@ class ApiClient {
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ message: response.statusText }));
-      throw new Error(`API Error (${response.status}): ${error.error?.message || error.message}`);
+      const errorMessage = error.error?.message || error.message || "Unknown error";
+      throw new Error(`API Error (${response.status}): ${errorMessage} - Path: ${path}`);
     }
     if (response.status === 204) {
       return;
@@ -548,9 +570,9 @@ class ApiClient {
     return response.data;
   }
   async linkFeatureToRoadmap(featureId, roadmapId) {
-    await this.request(`/v1/features/${featureId}/roadmap-items`, {
+    await this.request(`/v1/features/${featureId}/roadmap-links`, {
       method: "POST",
-      body: JSON.stringify({ roadmapItemId: roadmapId })
+      body: JSON.stringify({ roadmapId })
     });
   }
   async listIdeas() {
@@ -698,6 +720,14 @@ class ApiClient {
     const response = await this.request(`/v1/history?${searchParams.toString()}`);
     return response.data;
   }
+  async getHistorySummary(params) {
+    const searchParams = new URLSearchParams({
+      startDate: params.startDate,
+      endDate: params.endDate
+    });
+    const response = await this.request(`/v1/history/summary?${searchParams}`);
+    return response.data;
+  }
   async saveStories(roadmapId, data) {
     const response = await this.request(`/v1/roadmaps/${roadmapId}/stories`, {
       method: "POST",
@@ -705,6 +735,34 @@ class ApiClient {
     });
     return response.data;
   }
+  async updateDesignDescription(roadmapId, description) {
+    const response = await this.request(`/v1/designs/roadmaps/${roadmapId}/design`, {
+      method: "PATCH",
+      body: JSON.stringify({ description })
+    });
+    return response.data;
+  }
+  async updatePlanDescription(roadmapId, description) {
+    const response = await this.request(`/v1/plans/roadmaps/${roadmapId}/plan`, {
+      method: "PATCH",
+      body: JSON.stringify({ description })
+    });
+    return response.data;
+  }
+  async updateBuildDescription(roadmapId, data) {
+    const response = await this.request(`/v1/builds/roadmaps/${roadmapId}/build`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
+  async updateReleaseDescription(roadmapId, description) {
+    const response = await this.request(`/v1/releases/roadmaps/${roadmapId}/release`, {
+      method: "PATCH",
+      body: JSON.stringify({ description })
+    });
+    return response.data;
+  }
 }
 var client = null;
 function getApiClient() {
@@ -753,6 +811,7 @@ function registerAllTools(server) {
   registerDeleteAudience(server);
   registerListStatusUpdates(server);
   registerGetHistory(server);
+  registerGetHistorySummary(server);
   registerCreateStatusUpdate(server);
   registerSaveStories(server);
 }
@@ -849,6 +908,11 @@ function registerGetRoadmap(server) {
             })),
             epics: roadmap2.epics,
             stories: roadmap2.stories,
+            designDescription: roadmap2.design?.description ?? null,
+            planDescription: roadmap2.plan?.description ?? null,
+            buildDescription: roadmap2.build?.description ?? null,
+            releaseDescription: roadmap2.release?.description ?? null,
+            prompt: roadmap2.build?.prompt ?? roadmap2.prompt ?? null,
             createdAt: roadmap2.createdAt
           }, null, 2)
         }
@@ -1114,7 +1178,11 @@ function registerUpdateRoadmapItem(server) {
       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)")
+      order: z10.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)"),
+      designDescription: z10.string().nullable().optional().describe("Description for the Design phase"),
+      planDescription: z10.string().nullable().optional().describe("Description for the Planning phase"),
+      buildDescription: z10.string().nullable().optional().describe("Description for the Build phase"),
+      releaseDescription: z10.string().nullable().optional().describe("Description for the Release phase")
     }
   }, async ({
     id,
@@ -1123,7 +1191,11 @@ function registerUpdateRoadmapItem(server) {
     horizon,
     value,
     effort,
-    order
+    order,
+    designDescription,
+    planDescription,
+    buildDescription,
+    releaseDescription
   }) => {
     const client2 = getApiClient();
     const updates = {};
@@ -1140,6 +1212,23 @@ function registerUpdateRoadmapItem(server) {
     if (order !== undefined)
       updates.order = order;
     const roadmap2 = await client2.updateRoadmap(id, updates);
+    const phaseUpdates = {};
+    if (designDescription !== undefined) {
+      await client2.updateDesignDescription(id, designDescription);
+      phaseUpdates.designDescription = designDescription;
+    }
+    if (planDescription !== undefined) {
+      await client2.updatePlanDescription(id, planDescription);
+      phaseUpdates.planDescription = planDescription;
+    }
+    if (buildDescription !== undefined) {
+      await client2.updateBuildDescription(id, { description: buildDescription });
+      phaseUpdates.buildDescription = buildDescription;
+    }
+    if (releaseDescription !== undefined) {
+      await client2.updateReleaseDescription(id, releaseDescription);
+      phaseUpdates.releaseDescription = releaseDescription;
+    }
     return {
       content: [
         {
@@ -1154,7 +1243,8 @@ function registerUpdateRoadmapItem(server) {
               value: roadmap2.value,
               effort: roadmap2.effort,
               order: roadmap2.order
-            }
+            },
+            phaseDescriptionsUpdated: phaseUpdates
           }, null, 2)
         }
       ]
@@ -2034,7 +2124,7 @@ function registerListStatusUpdates(server) {
 }
 function registerGetHistory(server) {
   server.registerTool("get_history", {
-    description: "Get history events for a date range. Returns all changes (created, updated, deleted) to roadmaps, features, ideas, etc. Use this to gather data for generating status reports.",
+    description: "Get raw history events for a date range. Returns full event details including payloads. " + "Use entityType or entityId filters to narrow results. For status reports, prefer " + "get_history_summary to avoid context overflow.",
     inputSchema: {
       startDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("Start date in YYYY-MM-DD format"),
       endDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("End date in YYYY-MM-DD format"),
@@ -2066,6 +2156,26 @@ function registerGetHistory(server) {
     };
   });
 }
+function registerGetHistorySummary(server) {
+  server.registerTool("get_history_summary", {
+    description: "Get a summary of history events for a date range. Returns counts by entity type, " + "list of changed entities with titles, and total event count. Use this for status " + "report generation instead of get_history to avoid context overflow.",
+    inputSchema: {
+      startDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("Start date in YYYY-MM-DD format"),
+      endDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/).describe("End date in YYYY-MM-DD format")
+    }
+  }, async ({ startDate, endDate }) => {
+    const client2 = getApiClient();
+    const summary = await client2.getHistorySummary({ startDate, endDate });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(summary, null, 2)
+        }
+      ]
+    };
+  });
+}
 function registerCreateStatusUpdate(server) {
   server.registerTool("create_status_update", {
     description: "Create a new status report. Use this after generating the report content from history events.",

package/package.json

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