roadmap-skill 0.1.0 → 0.1.4

package/README.md

@@ -15,9 +15,14 @@
   <a href="https://www.npmjs.com/package/roadmap-skill"><img src="https://img.shields.io/npm/dm/roadmap-skill" alt="npm downloads"></a>
 </p>
 
+<p align="center">
+  <a href="https://insiders.vscode.dev/redirect/mcp/install?name=roadmap&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22roadmap-skill%22%5D%7D"><img src="https://img.shields.io/badge/VS_Code-Install%20MCP%20Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code"></a>
+  <a href="https://insiders.vscode.dev/redirect/mcp/install?name=roadmap&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22roadmap-skill%22%5D%7D&quality=insiders"><img src="https://img.shields.io/badge/VS_Code_Insiders-Install%20MCP%20Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders"></a>
+</p>
+
 ---
 
-## ✨ Why Roadmap Skill?
+## Why Roadmap Skill?
 
 **Tired of juggling multiple project management tools?** Roadmap Skill brings your tasks directly into your AI workflow while offering a beautiful visual interface when you need it.
 
@@ -33,23 +38,109 @@
 
 ## 🚀 Quick Start
 
-### Option 1: Standalone Web App (Easiest)
+### Option 1: Standalone Web App
 
 ```bash
 npx roadmap-skill-web
 ```
 
-Then open http://localhost:7860 in your browser.
+Then open <http://localhost:7860> in your browser.
 
 ### Option 2: Integrate with AI Assistants
 
 Add to your AI assistant's MCP configuration:
 
-**Claude Desktop:**
+<details>
+<summary><b>Claude Code</b></summary>
+
+```bash
+claude mcp add roadmap npx -y roadmap-skill
+```
+
+</details>
+
+<details>
+<summary><b>Claude Desktop</b></summary>
+
+```json
+{
+  "mcpServers": {
+    "roadmap": {
+      "command": "npx",
+      "args": ["-y", "roadmap-skill"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Copilot</b></summary>
+
+```bash
+/mcp add
+```
+
+Or edit `~/.copilot/mcp-config.json`:
+
+```json
+{
+  "mcpServers": {
+    "roadmap": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "roadmap-skill"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Cursor</b></summary>
+
+```json
+{
+  "mcpServers": {
+    "roadmap": {
+      "command": "npx",
+      "args": ["-y", "roadmap-skill"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>JetBrains (via Cline)</b></summary>
+
+Install Cline plugin, then add to `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "roadmap": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "roadmap-skill"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Roo Code</b></summary>
+
 ```json
 {
   "mcpServers": {
     "roadmap": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "roadmap-skill"]
     }
@@ -57,7 +148,37 @@ Add to your AI assistant's MCP configuration:
 }
 ```
 
-**Cursor:**
+</details>
+
+<details>
+<summary><b>Opencode</b></summary>
+
+Edit `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "roadmap": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "roadmap-skill"
+      ],
+      "enabled": true
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Trae</b></summary>
+
+Go to `Settings` -> `MCP` -> `Add new MCP Server`:
+
 ```json
 {
   "mcpServers": {
@@ -69,7 +190,63 @@ Add to your AI assistant's MCP configuration:
 }
 ```
 
-Then ask your AI:
+</details>
+
+<details>
+<summary><b>VS Code</b></summary>
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "roadmap": {
+        "command": "npx",
+        "args": ["-y", "roadmap-skill"]
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Windsurf</b></summary>
+
+Follow Windsurf MCP documentation and use:
+
+```json
+{
+  "mcpServers": {
+    "roadmap": {
+      "command": "npx",
+      "args": ["-y", "roadmap-skill"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><b>Zed</b></summary>
+
+```json
+{
+  "context_servers": {
+    "roadmap": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "roadmap-skill"]
+      }
+    }
+  }
+}
+```
+
+</details>
+
+Then ask your AI (e.g.):
 > "Create a project called 'Website Redesign' with tasks for homepage, about page, and contact form"
 
 ---
@@ -77,18 +254,21 @@ Then ask your AI:
 ## 💡 What You Can Do
 
 ### Plan Projects Visually
+
 - See all your tasks organized in Kanban columns
 - Switch between compact and detailed card views
 - Filter by status, project, or search keywords
 - Drag tasks to update their status instantly
 
 ### Work with AI
+
 - "Show me all high priority tasks due this week"
 - "Move the authentication task to in-progress"
 - "Create a new project for mobile app with 5 initial tasks"
 - "What's my overall progress across all projects?"
 
 ### Collaborate & Track
+
 - Assign tasks to team members
 - Set due dates and priorities
 - Add tags to organize related work
@@ -99,14 +279,17 @@ Then ask your AI:
 ## 📦 Installation
 
 ### Requirements
+
 - Node.js 18+ (20+ recommended)
 
 ### One-Line Install
+
 ```bash
 npm install -g roadmap-skill
 ```
 
 ### Or Use Without Installing
+
 ```bash
 npx roadmap-skill-web      # Just the web interface
 npx roadmap-skill          # Full MCP server
@@ -128,8 +311,8 @@ npx roadmap-skill          # Full MCP server
 
 ## 🔧 Supported Platforms
 
-- ✅ **Claude Desktop** — Full MCP integration
 - ✅ **Claude Code** — Command-line AI assistant
+- ✅ **Claude Desktop** — Full MCP integration
 - ✅ **Cursor** — AI-powered IDE
 - ✅ **VS Code** — Via Cline or Roo Code extensions
 - ✅ **Any MCP Client** — Standard MCP protocol support

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __esm = (fn, res) => function __init() {
@@ -79,6 +80,7 @@ import {
   GetPromptRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
 
 // src/tools/index.ts
 init_esm_shims();
@@ -1016,9 +1018,6 @@ init_esm_shims();
 init_esm_shims();
 import express from "express";
 import * as path4 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = path4.dirname(__filename2);
 function createServer(port = 7860) {
   const app = express();
   app.use(express.json());
@@ -1166,7 +1165,7 @@ function createServer(port = 7860) {
       res.status(500).json({ error: error.message });
     }
   });
-  const distPath = path4.join(__dirname2, "app");
+  const distPath = path4.join(process.cwd(), "dist", "web", "app");
   app.use(express.static(distPath));
   app.get("*", (req, res) => {
     if (req.path.startsWith("/api")) {
@@ -1182,7 +1181,15 @@ function createServer(port = 7860) {
 }
 
 // src/tools/web-tools.ts
+import open from "open";
 var activeServer = null;
+async function openBrowser(url) {
+  try {
+    await open(url);
+  } catch (error) {
+    console.error("Failed to open browser:", error);
+  }
+}
 var openWebInterfaceTool = {
   name: "open_web_interface",
   description: "Open web visualization interface",
@@ -1204,15 +1211,21 @@ var openWebInterfaceTool = {
     }
     const port = args.port || 7860;
     activeServer = createServer(port);
+    const url = `http://localhost:${port}`;
+    void openBrowser(url);
     return {
-      message: "Web interface started successfully",
-      url: `http://localhost:${port}`
+      message: "Web interface started successfully and opened in browser",
+      url
     };
   }
 };
 var closeWebInterfaceTool = {
   name: "close_web_interface",
   description: "Close web visualization interface",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
   async execute() {
     if (!activeServer) {
       return { message: "Web interface is not running" };
@@ -2090,7 +2103,7 @@ function createServer2() {
   const server = new Server(
     {
       name: "roadmap-skill",
-      version: "0.1.0"
+      version: "0.1.4"
     },
     {
       capabilities: {
@@ -2100,65 +2113,97 @@ function createServer2() {
       }
     }
   );
-  server.setRequestHandler(ListToolsRequestSchema, async (_request) => {
-    return {
-      tools: allTools.map((tool) => {
-        const inputSchema = tool.parameters || tool.inputSchema;
+  server.setRequestHandler(
+    ListToolsRequestSchema,
+    async (_request) => {
+      return {
+        tools: allTools.map((tool) => {
+          const rawSchema = tool.parameters || tool.inputSchema;
+          let inputSchema;
+          if (!rawSchema) {
+            inputSchema = { type: "object" };
+          } else if (rawSchema.type === "object") {
+            inputSchema = rawSchema;
+          } else {
+            inputSchema = zodToJsonSchema(rawSchema, {
+              name: tool.name,
+              $refStrategy: "none"
+            }).definitions?.[tool.name] || { type: "object" };
+          }
+          return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema
+          };
+        })
+      };
+    }
+  );
+  server.setRequestHandler(
+    CallToolRequestSchema,
+    async (request) => {
+      const { name, arguments: args } = request.params;
+      const tool = toolMap.get(name);
+      if (!tool) {
+        throw new Error(`Unknown tool: ${name}`);
+      }
+      try {
+        const result = await tool.execute(args);
         return {
-          name: tool.name,
-          description: tool.description,
-          inputSchema: inputSchema || { type: "object" }
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ]
         };
-      })
-    };
-  });
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    const tool = toolMap.get(name);
-    if (!tool) {
-      throw new Error(`Unknown tool: ${name}`);
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Tool execution failed: ${errorMessage}`);
+      }
     }
-    try {
-      const result = await tool.execute(args);
+  );
+  server.setRequestHandler(
+    ListResourcesRequestSchema,
+    async (_request) => {
+      const resources = getAllResources();
+      return { resources };
+    }
+  );
+  server.setRequestHandler(
+    ReadResourceRequestSchema,
+    async (request) => {
+      const uri = request.params.uri;
+      const resourceContent = await handleResourceRequest(uri);
+      if (!resourceContent) {
+        throw new Error(`Resource not found: ${uri}`);
+      }
       return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }
-        ]
+        contents: [resourceContent]
       };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      throw new Error(`Tool execution failed: ${errorMessage}`);
     }
-  });
-  server.setRequestHandler(ListResourcesRequestSchema, async (_request) => {
-    const resources = getAllResources();
-    return { resources };
-  });
-  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const uri = request.params.uri;
-    const resourceContent = await handleResourceRequest(uri);
-    if (!resourceContent) {
-      throw new Error(`Resource not found: ${uri}`);
+  );
+  server.setRequestHandler(
+    ListPromptsRequestSchema,
+    async (_request) => {
+      const prompts = getAllPrompts();
+      return { prompts };
     }
-    return {
-      contents: [resourceContent]
-    };
-  });
-  server.setRequestHandler(ListPromptsRequestSchema, async (_request) => {
-    const prompts = getAllPrompts();
-    return { prompts };
-  });
-  server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    const promptResult = getPromptByName(name, args);
-    if (!promptResult) {
-      throw new Error(`Prompt not found: ${name}`);
+  );
+  server.setRequestHandler(
+    GetPromptRequestSchema,
+    async (request) => {
+      const { name, arguments: args } = request.params;
+      const promptResult = getPromptByName(
+        name,
+        args
+      );
+      if (!promptResult) {
+        throw new Error(`Prompt not found: ${name}`);
+      }
+      return promptResult;
     }
-    return promptResult;
-  });
+  );
   return server;
 }
 async function startServer() {