@ourroadmaps/mcp 0.5.0 → 0.7.0

package/dist/index.js

@@ -23670,6 +23670,70 @@ var updateProductSchema = exports_external.object({
   order: exports_external.number().int().optional()
 });
 var productListSchema = exports_external.array(productSchema);
+// ../../packages/shared/src/schemas/story.ts
+var epicSchema = exports_external.object({
+  id: exports_external.string().uuid(),
+  roadmapItemId: exports_external.string().uuid(),
+  organizationId: exports_external.string(),
+  title: exports_external.string(),
+  description: exports_external.string().nullable(),
+  order: exports_external.number().int(),
+  createdAt: exports_external.string(),
+  updatedAt: exports_external.string(),
+  deletedAt: exports_external.string().nullable()
+});
+var storySchema = exports_external.object({
+  id: exports_external.string().uuid(),
+  roadmapItemId: exports_external.string().uuid(),
+  epicId: exports_external.string().uuid().nullable(),
+  organizationId: exports_external.string(),
+  title: exports_external.string(),
+  description: exports_external.string().nullable(),
+  order: exports_external.number().int(),
+  createdAt: exports_external.string(),
+  updatedAt: exports_external.string(),
+  deletedAt: exports_external.string().nullable()
+});
+var epicWithStoriesSchema = epicSchema.extend({
+  stories: exports_external.array(storySchema)
+});
+var createEpicSchema = exports_external.object({
+  title: exports_external.string().min(1),
+  description: exports_external.string().nullable().optional()
+});
+var createStorySchema = exports_external.object({
+  title: exports_external.string().min(1),
+  description: exports_external.string().nullable().optional()
+});
+var saveStoriesInputSchema = exports_external.object({
+  epics: exports_external.array(exports_external.object({
+    title: exports_external.string().min(1),
+    description: exports_external.string().nullable().optional(),
+    stories: exports_external.array(exports_external.object({
+      title: exports_external.string().min(1),
+      description: exports_external.string().nullable().optional()
+    })).optional().default([])
+  })).optional().default([]),
+  stories: exports_external.array(exports_external.object({
+    title: exports_external.string().min(1),
+    description: exports_external.string().nullable().optional()
+  })).optional().default([])
+});
+var updateEpicSchema = exports_external.object({
+  title: exports_external.string().min(1).optional(),
+  description: exports_external.string().nullable().optional()
+});
+var updateStorySchema = exports_external.object({
+  title: exports_external.string().min(1).optional(),
+  description: exports_external.string().nullable().optional(),
+  epicId: exports_external.string().uuid().nullable().optional()
+});
+var reorderStoriesSchema = exports_external.object({
+  epicOrder: exports_external.array(exports_external.string().uuid()).optional(),
+  storyOrder: exports_external.record(exports_external.string(), exports_external.array(exports_external.string().uuid())).optional(),
+  standaloneOrder: exports_external.array(exports_external.string().uuid()).optional()
+});
+
 // ../../packages/shared/src/schemas/roadmap.ts
 var flexibleDateSchema = exports_external.object({
   value: exports_external.string(),
@@ -23782,7 +23846,9 @@ var roadmapDetailSchema = roadmapSchema.extend({
   wireframes: exports_external.array(wireframeSchema),
   brainstormMedia: exports_external.array(brainstormMediaSchema),
   brainstormNotes: exports_external.string().nullable(),
-  featureLinks: exports_external.array(featureLinkSchema)
+  featureLinks: exports_external.array(featureLinkSchema),
+  epics: exports_external.array(epicWithStoriesSchema),
+  stories: exports_external.array(storySchema)
 });
 var roadmapListSchema = exports_external.array(roadmapSchema);
 // ../../packages/shared/src/schemas/scenario.ts
@@ -23976,6 +24042,21 @@ class ApiClient {
     });
     return response.data;
   }
+  async getProduct(id) {
+    const response = await this.request(`/v1/products/${id}`);
+    return response.data;
+  }
+  async getProductDocumentation(productId) {
+    const response = await this.request(`/v1/products/${productId}/documentation`);
+    return response.data;
+  }
+  async updateProductDocumentation(productId, data) {
+    const response = await this.request(`/v1/products/${productId}/documentation`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
   async listAudiences() {
     const response = await this.request("/v1/audiences");
     return response.data;
@@ -24055,6 +24136,13 @@ class ApiClient {
     const response = await this.request(`/v1/history?${searchParams.toString()}`);
     return response.data;
   }
+  async saveStories(roadmapId, data) {
+    const response = await this.request(`/v1/roadmaps/${roadmapId}/stories`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
 }
 var client = null;
 function getApiClient() {
@@ -24093,12 +24181,17 @@ function registerAllTools(server) {
   registerCreateProduct(server);
   registerUpdateProduct(server);
   registerDeleteProduct(server);
+  registerGetProduct(server);
+  registerSearchProducts(server);
+  registerGetProductDocumentation(server);
+  registerUpdateProductDocumentation(server);
   registerCreateAudience(server);
   registerUpdateAudience(server);
   registerDeleteAudience(server);
   registerListStatusUpdates(server);
   registerGetHistory(server);
   registerCreateStatusUpdate(server);
+  registerSaveStories(server);
 }
 function registerSearchRoadmaps(server) {
   server.registerTool("search_roadmaps", {
@@ -24142,7 +24235,7 @@ function registerSearchRoadmaps(server) {
 }
 function registerGetRoadmap(server) {
   server.registerTool("get_roadmap", {
-    description: "Get full details of a roadmap item including PRD, wireframes, brainstorm media, linked features, and scenarios.",
+    description: "Get full details of a roadmap item including PRD, wireframes, brainstorm media, linked features, epics, and stories.",
     inputSchema: {
       id: exports_external.string().describe("The UUID of the roadmap item")
     }
@@ -24177,6 +24270,8 @@ function registerGetRoadmap(server) {
               featureName: l.feature.name,
               featureType: l.feature.type
             })),
+            epics: roadmap2.epics,
+            stories: roadmap2.stories,
             createdAt: roadmap2.createdAt
           }, null, 2)
         }
@@ -25043,6 +25138,145 @@ function registerDeleteProduct(server) {
     };
   });
 }
+function registerGetProduct(server) {
+  server.registerTool("get_product", {
+    description: "Get full details of a product by ID, including its documentation (design system and ADRs).",
+    inputSchema: {
+      id: exports_external.string().describe("The UUID of the product")
+    }
+  }, async ({ id }) => {
+    const client2 = getApiClient();
+    const [product2, documentation] = await Promise.all([
+      client2.getProduct(id),
+      client2.getProductDocumentation(id)
+    ]);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            product: {
+              id: product2.id,
+              type: product2.type,
+              name: product2.name,
+              parentId: product2.parentId,
+              order: product2.order,
+              isExpanded: product2.isExpanded,
+              createdAt: product2.createdAt
+            },
+            documentation: documentation ? {
+              designSystem: documentation.designSystem,
+              adrs: documentation.adrs,
+              updatedAt: documentation.updatedAt
+            } : null
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerSearchProducts(server) {
+  server.registerTool("search_products", {
+    description: "Search for products by name. Returns a list of matching products with basic info.",
+    inputSchema: {
+      query: exports_external.string().optional().describe("Search query to match against product name"),
+      type: productTypeSchema2.optional().describe("Filter by product type")
+    }
+  }, async ({ query, type }) => {
+    const client2 = getApiClient();
+    let products = await client2.listProducts();
+    if (query) {
+      const lowerQuery = query.toLowerCase();
+      products = products.filter((p) => p.name.toLowerCase().includes(lowerQuery));
+    }
+    if (type) {
+      products = products.filter((p) => p.type === type);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            count: products.length,
+            products: products.map((p) => ({
+              id: p.id,
+              type: p.type,
+              name: p.name,
+              parentId: p.parentId
+            }))
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerGetProductDocumentation(server) {
+  server.registerTool("get_product_documentation", {
+    description: "Get the documentation (design system and ADRs) for a product. Use this to read existing documentation before updating.",
+    inputSchema: {
+      productId: exports_external.string().describe("The UUID of the product")
+    }
+  }, async ({ productId }) => {
+    const client2 = getApiClient();
+    const documentation = await client2.getProductDocumentation(productId);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            productId,
+            documentation: documentation ? {
+              id: documentation.id,
+              designSystem: documentation.designSystem,
+              adrs: documentation.adrs,
+              createdAt: documentation.createdAt,
+              updatedAt: documentation.updatedAt
+            } : null
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerUpdateProductDocumentation(server) {
+  server.registerTool("update_product_documentation", {
+    description: "Update the documentation for a product. Use this to keep design system and ADRs up to date. Creates documentation if it does not exist.",
+    inputSchema: {
+      productId: exports_external.string().describe("The UUID of the product"),
+      designSystem: exports_external.string().nullable().optional().describe("Design system documentation - colors, typography, spacing, components. Pass null to clear."),
+      adrs: exports_external.string().nullable().optional().describe("Architecture Decision Records - document key technical decisions. Pass null to clear.")
+    }
+  }, async ({
+    productId,
+    designSystem,
+    adrs
+  }) => {
+    const client2 = getApiClient();
+    const updates = {};
+    if (designSystem !== undefined)
+      updates.designSystem = designSystem;
+    if (adrs !== undefined)
+      updates.adrs = adrs;
+    const documentation = await client2.updateProductDocumentation(productId, updates);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            documentation: {
+              id: documentation.id,
+              productId: documentation.productId,
+              designSystem: documentation.designSystem,
+              adrs: documentation.adrs,
+              updatedAt: documentation.updatedAt
+            }
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
 var audienceTypeSchema2 = exports_external.enum(["stakeholder", "user_persona"]);
 function registerCreateAudience(server) {
   server.registerTool("create_audience", {
@@ -25258,6 +25492,49 @@ function registerCreateStatusUpdate(server) {
     };
   });
 }
+function registerSaveStories(server) {
+  server.registerTool("save_stories", {
+    description: "Save epics and stories for a roadmap item. Replaces all existing epics/stories. Use this to set the complete list of epics and stories for a roadmap.",
+    inputSchema: {
+      roadmapId: exports_external.string().uuid().describe("The UUID of the roadmap item"),
+      epics: exports_external.array(exports_external.object({
+        title: exports_external.string().min(1).describe("Title of the epic"),
+        description: exports_external.string().nullable().optional().describe("Description of the epic"),
+        stories: exports_external.array(exports_external.object({
+          title: exports_external.string().min(1).describe("Title of the story"),
+          description: exports_external.string().nullable().optional().describe("Description of the story")
+        })).optional().describe("Stories within this epic")
+      })).optional().describe("List of epics with their nested stories"),
+      stories: exports_external.array(exports_external.object({
+        title: exports_external.string().min(1).describe("Title of the story"),
+        description: exports_external.string().nullable().optional().describe("Description of the story")
+      })).optional().describe("List of standalone stories (not part of any epic)")
+    }
+  }, async ({
+    roadmapId,
+    epics,
+    stories
+  }) => {
+    const client2 = getApiClient();
+    const result = await client2.saveStories(roadmapId, {
+      epics: epics ?? [],
+      stories: stories ?? []
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            epicCount: result.epics.length,
+            storyCount: result.stories.length,
+            totalStories: result.stories.length + result.epics.reduce((sum, epic) => sum + (epic.stories?.length ?? 0), 0)
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
 
 // src/index.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ourroadmaps/mcp",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "MCP server for OurRoadmaps - manage roadmaps, features, and ideas from Claude Code",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "url": "https://github.com/bgraner/roadmaps3.git",
     "directory": "apps/mcp"
   },
-  "license": "MIT",
+  "license": "UNLICENSED",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
     "@ourroadmaps/shared": "*",