@ourroadmaps/mcp 0.18.1 → 0.20.0

package/dist/index.js

@@ -22,10 +22,28 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 // ../../packages/shared/src/schemas/audience.ts
-import { z as z2 } from "zod";
-
-// ../../packages/shared/src/schemas/constants.ts
 import { z } from "zod";
+var audienceSchema = z.object({
+  id: z.string().uuid(),
+  organizationId: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  order: z.number().int(),
+  createdAt: z.string(),
+  updatedAt: z.string().nullable()
+});
+var createAudienceSchema = z.object({
+  name: z.string().min(1),
+  description: z.string().nullable().optional()
+});
+var updateAudienceSchema = z.object({
+  name: z.string().min(1).optional(),
+  description: z.string().nullable().optional(),
+  order: z.number().int().optional()
+});
+var audienceListSchema = z.array(audienceSchema);
+// ../../packages/shared/src/schemas/constants.ts
+import { z as z2 } from "zod";
 var HORIZONS = [
   "inbox",
   "now",
@@ -36,7 +54,7 @@ var HORIZONS = [
   "done",
   "cancelled"
 ];
-var horizonSchema = z.enum(HORIZONS);
+var horizonSchema = z2.enum(HORIZONS);
 var ROADMAP_STATUSES = [
   "not_started",
   "planning",
@@ -46,17 +64,17 @@ var ROADMAP_STATUSES = [
   "done",
   "cancelled"
 ];
-var roadmapStatusSchema = z.enum(ROADMAP_STATUSES);
+var roadmapStatusSchema = z2.enum(ROADMAP_STATUSES);
 var EFFORT_SIZES = ["xs", "s", "m", "l", "xl"];
-var effortSchema = z.enum(EFFORT_SIZES);
+var effortSchema = z2.enum(EFFORT_SIZES);
 var DATE_GRANULARITIES = ["day", "month", "quarter", "half-year", "year"];
-var dateGranularitySchema = z.enum(DATE_GRANULARITIES);
+var dateGranularitySchema = z2.enum(DATE_GRANULARITIES);
 var PRD_STATUSES = ["draft", "completed"];
-var prdStatusSchema = z.enum(PRD_STATUSES);
+var prdStatusSchema = z2.enum(PRD_STATUSES);
 var IDEA_STATUSES = ["new", "under-review", "planned", "declined", "done"];
-var ideaStatusSchema = z.enum(IDEA_STATUSES);
+var ideaStatusSchema = z2.enum(IDEA_STATUSES);
 var FEATURE_TYPES = ["area", "feature"];
-var featureTypeSchema = z.enum(FEATURE_TYPES);
+var featureTypeSchema = z2.enum(FEATURE_TYPES);
 var PRODUCT_TYPES = [
   "brand",
   "product",
@@ -65,41 +83,11 @@ var PRODUCT_TYPES = [
   "landing_page",
   "service"
 ];
-var productTypeSchema = z.enum(PRODUCT_TYPES);
+var productTypeSchema = z2.enum(PRODUCT_TYPES);
 var AUDIENCE_TYPES = ["stakeholder", "user_persona"];
-var audienceTypeSchema = z.enum(AUDIENCE_TYPES);
+var audienceTypeSchema = z2.enum(AUDIENCE_TYPES);
 var BRAINSTORM_MEDIA_TYPES = ["image", "video"];
-var brainstormMediaTypeSchema = z.enum(BRAINSTORM_MEDIA_TYPES);
-
-// ../../packages/shared/src/schemas/audience.ts
-var audienceSchema = z2.object({
-  id: z2.string().uuid(),
-  organizationId: z2.string(),
-  type: audienceTypeSchema,
-  role: z2.string().nullable(),
-  likes: z2.string().nullable(),
-  dislikes: z2.string().nullable(),
-  priorities: z2.string().nullable(),
-  order: z2.number().int(),
-  deletedAt: z2.string().nullable(),
-  createdAt: z2.string()
-});
-var createAudienceSchema = z2.object({
-  type: audienceTypeSchema,
-  role: z2.string().min(1),
-  likes: z2.string().nullable().optional(),
-  dislikes: z2.string().nullable().optional(),
-  priorities: z2.string().nullable().optional()
-});
-var updateAudienceSchema = z2.object({
-  type: audienceTypeSchema.optional(),
-  role: z2.string().min(1).optional(),
-  likes: z2.string().nullable().optional(),
-  dislikes: z2.string().nullable().optional(),
-  priorities: z2.string().nullable().optional(),
-  order: z2.number().int().optional()
-});
-var audienceListSchema = z2.array(audienceSchema);
+var brainstormMediaTypeSchema = z2.enum(BRAINSTORM_MEDIA_TYPES);
 // ../../packages/shared/src/schemas/context.ts
 import { z as z3 } from "zod";
 var domainContextSchema = z3.object({
@@ -899,6 +887,36 @@ class ApiClient {
       method: "DELETE"
     });
   }
+  async listInitiatives() {
+    const response = await this.request("/v1/initiatives");
+    return response.data;
+  }
+  async getInitiative(id) {
+    return await this.request(`/v1/initiatives/${id}`);
+  }
+  async createInitiative(data) {
+    return await this.request("/v1/initiatives", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async updateInitiative(id, data) {
+    return await this.request(`/v1/initiatives/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteInitiative(id) {
+    await this.request(`/v1/initiatives/${id}`, {
+      method: "DELETE"
+    });
+  }
+  async reorderInitiatives(items) {
+    return await this.request("/v1/initiatives/reorder", {
+      method: "POST",
+      body: JSON.stringify({ items })
+    });
+  }
   async updateDesignDescription(roadmapId, description) {
     const response = await this.request(`/v1/designs/roadmaps/${roadmapId}/design`, {
       method: "PATCH",
@@ -1018,6 +1036,12 @@ function registerAllTools(server) {
   registerGetHistorySummary(server);
   registerCreateStatusUpdate(server);
   registerSaveStories(server);
+  registerSearchInitiatives(server);
+  registerGetInitiative(server);
+  registerCreateInitiative(server);
+  registerUpdateInitiative(server);
+  registerDeleteInitiative(server);
+  registerReorderInitiatives(server);
   registerUploadWireframe(server);
   registerUpdateWireframe(server);
   registerDeleteWireframe(server);
@@ -1345,19 +1369,25 @@ function registerCreateRoadmapItem(server) {
     inputSchema: {
       title: z11.string().describe("Title of the roadmap item"),
       status: roadmapStatusSchema.optional().describe('Status (defaults to "not_started")'),
-      horizon: horizonSchema.optional().describe('Planning horizon (defaults to "inbox")')
+      horizon: horizonSchema.optional().describe('Planning horizon (defaults to "inbox")'),
+      initiativeId: z11.string().optional().describe("UUID of initiative to link this item to on creation")
     }
   }, async ({
     title,
     status,
-    horizon
+    horizon,
+    initiativeId
   }) => {
     const client2 = getApiClient();
-    const roadmap2 = await client2.createRoadmap({
+    const createData = {
       title,
       status: status ?? "not_started",
       horizon: horizon ?? "inbox"
-    });
+    };
+    if (initiativeId) {
+      createData.initiativeId = initiativeId;
+    }
+    const roadmap2 = await client2.createRoadmap(createData);
     return {
       content: [
         {
@@ -1379,7 +1409,7 @@ function registerCreateRoadmapItem(server) {
 var effortSizeSchema = z11.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, value, effort, order, prompt, or brainstorm notes.",
+    description: "Update an existing roadmap item. Can update title, status, horizon, value, effort, order, prompt, initiative link, target date, or brainstorm notes.",
     inputSchema: {
       id: z11.string().describe("The UUID of the roadmap item to update"),
       title: z11.string().optional().describe("New title"),
@@ -1388,11 +1418,14 @@ function registerUpdateRoadmapItem(server) {
       value: z11.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: z11.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)"),
+      initiativeId: z11.string().nullable().optional().describe("UUID to link item to initiative, or null to unlink from any initiative"),
       designDescription: z11.string().nullable().optional().describe("Description for the Design phase"),
       planDescription: z11.string().nullable().optional().describe("Description for the Planning phase"),
       buildDescription: z11.string().nullable().optional().describe("Description for the Build phase"),
       releaseDescription: z11.string().nullable().optional().describe("Description for the Release phase"),
-      prompt: z11.string().nullable().optional().describe("Build prompt for the roadmap item")
+      prompt: z11.string().nullable().optional().describe("Build prompt for the roadmap item"),
+      dateGranularity: dateGranularitySchema2.nullable().optional().describe("Target date granularity: day, month, quarter, half_year, or year"),
+      dateValue: z11.string().nullable().optional().describe('Target date value matching granularity (e.g., "2024-03-15" for day, "2024-Q1" for quarter)')
     }
   }, async ({
     id,
@@ -1402,11 +1435,14 @@ function registerUpdateRoadmapItem(server) {
     value,
     effort,
     order,
+    initiativeId,
     designDescription,
     planDescription,
     buildDescription,
     releaseDescription,
-    prompt
+    prompt,
+    dateGranularity,
+    dateValue
   }) => {
     const client2 = getApiClient();
     const updates = {};
@@ -1422,6 +1458,12 @@ function registerUpdateRoadmapItem(server) {
       updates.effort = effort;
     if (order !== undefined)
       updates.order = order;
+    if (initiativeId !== undefined)
+      updates.initiativeId = initiativeId;
+    if (dateGranularity !== undefined)
+      updates.dateGranularity = dateGranularity;
+    if (dateValue !== undefined)
+      updates.dateValue = dateValue;
     const roadmap2 = Object.keys(updates).length > 0 ? await client2.updateRoadmap(id, updates) : await client2.getRoadmap(id);
     const phaseUpdates = {};
     if (designDescription !== undefined) {
@@ -1461,7 +1503,9 @@ function registerUpdateRoadmapItem(server) {
               horizon: roadmap2.horizon,
               value: roadmap2.value,
               effort: roadmap2.effort,
-              order: roadmap2.order
+              order: roadmap2.order,
+              dateGranularity: roadmap2.dateGranularity,
+              dateValue: roadmap2.dateValue
             },
             phaseDescriptionsUpdated: phaseUpdates
           }, null, 2)
@@ -2201,31 +2245,21 @@ function registerUpdateProductDocumentation(server) {
     };
   });
 }
-var audienceTypeSchema2 = z11.enum(["stakeholder", "user_persona"]);
 function registerCreateAudience(server) {
   server.registerTool("create_audience", {
-    description: "Create a new audience member - either a stakeholder or user persona. Audiences represent who the product serves.",
+    description: "Create a new audience member. Audiences represent who the product serves.",
     inputSchema: {
-      type: audienceTypeSchema2.describe("Type of audience - stakeholder or user_persona"),
-      role: z11.string().describe('Role or title of the audience (e.g., "Product Manager", "End User")'),
-      likes: z11.string().nullable().optional().describe("What this audience likes or values"),
-      dislikes: z11.string().nullable().optional().describe("What this audience dislikes or avoids"),
-      priorities: z11.string().nullable().optional().describe("Key priorities for this audience")
+      name: z11.string().describe('Name of the audience (e.g., "Product Manager", "End User")'),
+      description: z11.string().nullable().optional().describe("Description of the audience")
     }
   }, async ({
-    type,
-    role,
-    likes,
-    dislikes,
-    priorities
+    name,
+    description
   }) => {
     const client2 = getApiClient();
     const audience2 = await client2.createAudience({
-      type,
-      role,
-      likes: likes ?? null,
-      dislikes: dislikes ?? null,
-      priorities: priorities ?? null
+      name,
+      description: description ?? null
     });
     return {
       content: [
@@ -2235,11 +2269,8 @@ function registerCreateAudience(server) {
             success: true,
             audience: {
               id: audience2.id,
-              type: audience2.type,
-              role: audience2.role,
-              likes: audience2.likes,
-              dislikes: audience2.dislikes,
-              priorities: audience2.priorities
+              name: audience2.name,
+              description: audience2.description
             }
           }, null, 2)
         }
@@ -2252,32 +2283,20 @@ function registerUpdateAudience(server) {
     description: "Update an existing audience member.",
     inputSchema: {
       id: z11.string().describe("The UUID of the audience to update"),
-      type: audienceTypeSchema2.optional().describe("New type"),
-      role: z11.string().optional().describe("New role"),
-      likes: z11.string().nullable().optional().describe("New likes"),
-      dislikes: z11.string().nullable().optional().describe("New dislikes"),
-      priorities: z11.string().nullable().optional().describe("New priorities")
+      name: z11.string().optional().describe("New name"),
+      description: z11.string().nullable().optional().describe("New description")
     }
   }, async ({
     id,
-    type,
-    role,
-    likes,
-    dislikes,
-    priorities
+    name,
+    description
   }) => {
     const client2 = getApiClient();
     const updates = {};
-    if (type !== undefined)
-      updates.type = type;
-    if (role !== undefined)
-      updates.role = role;
-    if (likes !== undefined)
-      updates.likes = likes;
-    if (dislikes !== undefined)
-      updates.dislikes = dislikes;
-    if (priorities !== undefined)
-      updates.priorities = priorities;
+    if (name !== undefined)
+      updates.name = name;
+    if (description !== undefined)
+      updates.description = description;
     const audience2 = await client2.updateAudience(id, updates);
     return {
       content: [
@@ -2287,11 +2306,8 @@ function registerUpdateAudience(server) {
             success: true,
             audience: {
               id: audience2.id,
-              type: audience2.type,
-              role: audience2.role,
-              likes: audience2.likes,
-              dislikes: audience2.dislikes,
-              priorities: audience2.priorities
+              name: audience2.name,
+              description: audience2.description
             }
           }, null, 2)
         }
@@ -3068,6 +3084,231 @@ Expires: ${expiryDate}`
     };
   });
 }
+var dateGranularitySchema2 = z11.enum(["day", "month", "quarter", "half_year", "year"]);
+function registerSearchInitiatives(server) {
+  server.registerTool("search_initiatives", {
+    description: "Search for initiatives by title or filter by horizon. Returns a list of matching initiatives with item counts.",
+    inputSchema: {
+      query: z11.string().optional().describe("Search query to match against title or description"),
+      horizon: horizonSchema.optional().describe("Filter by planning horizon"),
+      limit: z11.number().int().min(1).max(100).optional().describe("Max items to return (default 10)"),
+      offset: z11.number().int().min(0).optional().describe("Number of items to skip (default 0)")
+    }
+  }, async ({
+    query,
+    horizon,
+    limit = 10,
+    offset = 0
+  }) => {
+    const client2 = getApiClient();
+    let initiatives = await client2.listInitiatives();
+    if (query) {
+      const lowerQuery = query.toLowerCase();
+      initiatives = initiatives.filter((i) => i.title.toLowerCase().includes(lowerQuery) || i.description?.toLowerCase().includes(lowerQuery));
+    }
+    if (horizon) {
+      initiatives = initiatives.filter((i) => i.horizon === horizon);
+    }
+    const total = initiatives.length;
+    const paginatedInitiatives = initiatives.slice(offset, offset + limit);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            items: paginatedInitiatives.map((i) => ({
+              id: i.id,
+              title: i.title,
+              description: i.description,
+              horizon: i.horizon,
+              targetDate: i.targetDate,
+              itemCount: i.itemCount,
+              doneCount: i.doneCount,
+              order: i.order
+            })),
+            pagination: {
+              limit,
+              offset,
+              total,
+              hasMore: offset + limit < total
+            }
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerGetInitiative(server) {
+  server.registerTool("get_initiative", {
+    description: "Get full details of an initiative including all linked roadmap items.",
+    inputSchema: {
+      id: z11.string().describe("The UUID of the initiative")
+    }
+  }, async ({ id }) => {
+    const client2 = getApiClient();
+    const result = await client2.getInitiative(id);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerCreateInitiative(server) {
+  server.registerTool("create_initiative", {
+    description: "Create a new initiative. Initiatives group related roadmap items for cross-functional coordination.",
+    inputSchema: {
+      title: z11.string().describe("Title of the initiative"),
+      description: z11.string().optional().describe("Description of the initiative (markdown)"),
+      horizon: horizonSchema.optional().describe('Planning horizon (defaults to "inbox")'),
+      dateGranularity: dateGranularitySchema2.optional().describe("Target date granularity: day, month, quarter, half_year, or year"),
+      dateValue: z11.string().optional().describe('Target date value matching granularity (e.g., "2024-Q1", "2024-03")'),
+      targetDate: z11.string().optional().describe("Target date in YYYY-MM-DD format")
+    }
+  }, async ({
+    title,
+    description,
+    horizon,
+    dateGranularity,
+    dateValue,
+    targetDate
+  }) => {
+    const client2 = getApiClient();
+    const initiative = await client2.createInitiative({
+      title,
+      description: description ?? null,
+      horizon: horizon ?? "inbox",
+      dateGranularity: dateGranularity ?? null,
+      dateValue: dateValue ?? null,
+      targetDate: targetDate ?? null
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            initiative: {
+              id: initiative.id,
+              title: initiative.title,
+              description: initiative.description,
+              horizon: initiative.horizon,
+              targetDate: initiative.targetDate,
+              itemCount: initiative.itemCount,
+              doneCount: initiative.doneCount
+            }
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerUpdateInitiative(server) {
+  server.registerTool("update_initiative", {
+    description: "Update an existing initiative.",
+    inputSchema: {
+      id: z11.string().describe("The UUID of the initiative to update"),
+      title: z11.string().optional().describe("New title"),
+      description: z11.string().nullable().optional().describe("New description (null to clear)"),
+      horizon: horizonSchema.optional().describe("New planning horizon"),
+      dateGranularity: dateGranularitySchema2.nullable().optional().describe("New target date granularity (null to clear)"),
+      dateValue: z11.string().nullable().optional().describe("New target date value (null to clear)"),
+      targetDate: z11.string().nullable().optional().describe("New target date in YYYY-MM-DD format (null to clear)"),
+      order: z11.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)")
+    }
+  }, async ({
+    id,
+    title,
+    description,
+    horizon,
+    dateGranularity,
+    dateValue,
+    targetDate,
+    order
+  }) => {
+    const client2 = getApiClient();
+    const updates = {};
+    if (title !== undefined)
+      updates.title = title;
+    if (description !== undefined)
+      updates.description = description;
+    if (horizon !== undefined)
+      updates.horizon = horizon;
+    if (dateGranularity !== undefined)
+      updates.dateGranularity = dateGranularity;
+    if (dateValue !== undefined)
+      updates.dateValue = dateValue;
+    if (targetDate !== undefined)
+      updates.targetDate = targetDate;
+    if (order !== undefined)
+      updates.order = order;
+    const initiative = await client2.updateInitiative(id, updates);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            initiative: {
+              id: initiative.id,
+              title: initiative.title,
+              description: initiative.description,
+              horizon: initiative.horizon,
+              targetDate: initiative.targetDate,
+              itemCount: initiative.itemCount,
+              doneCount: initiative.doneCount,
+              order: initiative.order
+            }
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerDeleteInitiative(server) {
+  server.registerTool("delete_initiative", {
+    description: "Delete an initiative. This is a soft delete that also unlinks all roadmap items from the initiative.",
+    inputSchema: {
+      id: z11.string().describe("The UUID of the initiative to delete")
+    }
+  }, async ({ id }) => {
+    const client2 = getApiClient();
+    await client2.deleteInitiative(id);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ success: true, deleted: id }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerReorderInitiatives(server) {
+  server.registerTool("reorder_initiatives", {
+    description: "Bulk reorder initiatives by setting their order values. Lower order values appear first.",
+    inputSchema: {
+      items: z11.array(z11.object({
+        id: z11.string().describe("The UUID of the initiative"),
+        order: z11.number().int().min(0).describe("The new order value (0-based)")
+      })).describe("Array of initiatives with their new order values")
+    }
+  }, async ({ items }) => {
+    const client2 = getApiClient();
+    await client2.reorderInitiatives(items);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ success: true, reordered: items.length }, null, 2)
+        }
+      ]
+    };
+  });
+}
 
 // src/index.ts
 async function main() {

package/package.json

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