@ourroadmaps/mcp 0.7.5 → 0.9.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
@@ -461,9 +482,15 @@ class ApiClient {
     }
     return await response.json();
   }
-  async listRoadmaps() {
-    const response = await this.request("/v1/roadmaps");
-    return response.data;
+  async listRoadmaps(params) {
+    const searchParams = new URLSearchParams;
+    if (params?.limit)
+      searchParams.set("limit", String(params.limit));
+    if (params?.offset)
+      searchParams.set("offset", String(params.offset));
+    const query = searchParams.toString();
+    const path = query ? `/v1/roadmaps?${query}` : "/v1/roadmaps";
+    return await this.request(path);
   }
   async getRoadmap(id) {
     const response = await this.request(`/v1/roadmaps/${id}`);
@@ -692,6 +719,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",
@@ -699,6 +734,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() {
@@ -747,6 +810,7 @@ function registerAllTools(server) {
   registerDeleteAudience(server);
   registerListStatusUpdates(server);
   registerGetHistory(server);
+  registerGetHistorySummary(server);
   registerCreateStatusUpdate(server);
   registerSaveStories(server);
 }
@@ -756,15 +820,20 @@ function registerSearchRoadmaps(server) {
     inputSchema: {
       query: z10.string().optional().describe("Search query to match against title or description"),
       status: roadmapStatusSchema.optional().describe("Filter by status"),
-      horizon: horizonSchema.optional().describe("Filter by planning horizon")
+      horizon: horizonSchema.optional().describe("Filter by planning horizon"),
+      limit: z10.number().int().min(1).max(100).optional().describe("Max items to return (default 10)"),
+      offset: z10.number().int().min(0).optional().describe("Number of items to skip (default 0)")
     }
   }, async ({
     query,
     status,
-    horizon
+    horizon,
+    limit,
+    offset
   }) => {
     const client2 = getApiClient();
-    let roadmaps = await client2.listRoadmaps();
+    const response = await client2.listRoadmaps({ limit, offset });
+    let roadmaps = response.items;
     if (query) {
       const q = query.toLowerCase();
       roadmaps = roadmaps.filter((r) => r.title.toLowerCase().includes(q));
@@ -779,15 +848,18 @@ function registerSearchRoadmaps(server) {
       content: [
         {
           type: "text",
-          text: JSON.stringify(roadmaps.map((r) => ({
-            id: r.id,
-            title: r.title,
-            status: r.status,
-            horizon: r.horizon,
-            value: r.value,
-            effort: r.effort,
-            order: r.order
-          })), null, 2)
+          text: JSON.stringify({
+            items: roadmaps.map((r) => ({
+              id: r.id,
+              title: r.title,
+              status: r.status,
+              horizon: r.horizon,
+              value: r.value,
+              effort: r.effort,
+              order: r.order
+            })),
+            pagination: response.pagination
+          }, null, 2)
         }
       ]
     };
@@ -835,6 +907,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)
         }
@@ -954,28 +1031,20 @@ function registerGetContext(server) {
 - 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
+- Roadmap Summary: Total count of roadmap items
 
 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, features, roadmaps] = await Promise.all([
+    const [strategy, products, audiences, scenarios, features, roadmapsResponse] = await Promise.all([
       client2.getStrategy(),
       client2.listProducts(),
       client2.listAudiences(),
       client2.listScenarios(),
       client2.listFeatures(),
-      client2.listRoadmaps()
+      client2.listRoadmaps({ limit: 1 })
     ]);
-    const statusCounts = {};
-    const horizonCounts = {};
-    for (const r of roadmaps) {
-      const status = r.status ?? "unknown";
-      const horizon = r.horizon ?? "unknown";
-      statusCounts[status] = (statusCounts[status] || 0) + 1;
-      horizonCounts[horizon] = (horizonCounts[horizon] || 0) + 1;
-    }
     return {
       content: [
         {
@@ -1013,9 +1082,7 @@ Use this as your FIRST call when starting work on a roadmap to understand the fu
               parentId: f.parentId
             })),
             roadmapSummary: {
-              total: roadmaps.length,
-              byStatus: statusCounts,
-              byHorizon: horizonCounts
+              total: roadmapsResponse.pagination.total
             }
           }, null, 2)
         }
@@ -1110,7 +1177,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,
@@ -1119,7 +1190,11 @@ function registerUpdateRoadmapItem(server) {
     horizon,
     value,
     effort,
-    order
+    order,
+    designDescription,
+    planDescription,
+    buildDescription,
+    releaseDescription
   }) => {
     const client2 = getApiClient();
     const updates = {};
@@ -1136,6 +1211,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: [
         {
@@ -1150,7 +1242,8 @@ function registerUpdateRoadmapItem(server) {
               value: roadmap2.value,
               effort: roadmap2.effort,
               order: roadmap2.order
-            }
+            },
+            phaseDescriptionsUpdated: phaseUpdates
           }, null, 2)
         }
       ]
@@ -2030,7 +2123,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"),
@@ -2062,6 +2155,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.7.5",
+  "version": "0.9.0",
   "description": "MCP server for OurRoadmaps - manage roadmaps, features, and ideas from Claude Code",
   "type": "module",
   "bin": {