roadmap-skill 0.2.9 → 0.2.11

package/dist/index.js

@@ -345,14 +345,15 @@ var storage = new ProjectStorage();
 // src/tools/project-tools.ts
 var ProjectTypeEnum = z.enum(["roadmap", "skill-tree", "kanban"]);
 var ProjectStatusEnum = z.enum(["active", "completed", "archived"]);
-function toProjectSummary(project, taskCount) {
+function toProjectSummary(project, taskCount, tags) {
   return {
     id: project.id,
     name: project.name,
     projectType: project.projectType,
     status: project.status,
     targetDate: project.targetDate,
-    taskCount
+    taskCount,
+    ...tags ? { tags } : {}
   };
 }
 function toTaskSummary(task) {
@@ -401,16 +402,33 @@ var createProjectTool = {
 };
 var listProjectsTool = {
   name: "list_projects",
-  description: "List all projects. Returns summaries by default; set verbose=true for full project data.",
+  description: "List all projects. Summary mode includes current project tags for Agent reuse. Set verbose=true for full project data.",
   inputSchema: z.object({
     verbose: z.boolean().optional()
   }),
   async execute(input) {
     try {
       const projects = await storage.listProjects();
+      if (input.verbose) {
+        return {
+          success: true,
+          data: projects
+        };
+      }
+      const summaries = await Promise.all(
+        projects.map(async (projectSummary) => {
+          const projectData = await storage.readProject(projectSummary.project.id);
+          const tags = (projectData?.tags ?? []).map((tag) => ({
+            id: tag.id,
+            name: tag.name,
+            color: tag.color
+          }));
+          return toProjectSummary(projectSummary.project, projectSummary.taskCount, tags);
+        })
+      );
       return {
         success: true,
-        data: input.verbose ? projects : projects.map((p) => toProjectSummary(p.project, p.taskCount))
+        data: summaries
       };
     } catch (error) {
       return {
@@ -533,6 +551,39 @@ init_esm_shims();
 function generateTagId() {
   return `tag_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
 }
+var HEX_COLOR_PATTERN = /^#[0-9A-Fa-f]{6}$/;
+var TAG_COLOR_PALETTE = [
+  "#FF6B6B",
+  "#FF9F43",
+  "#FDCB6E",
+  "#6C5CE7",
+  "#74B9FF",
+  "#00B894",
+  "#00CEC9",
+  "#E17055",
+  "#FAB1A0",
+  "#55A3FF",
+  "#A29BFE",
+  "#FD79A8"
+];
+function hashTagName(value) {
+  let hash = 5381;
+  for (const char of value.toLowerCase()) {
+    hash = hash * 33 ^ char.charCodeAt(0);
+  }
+  return Math.abs(hash >>> 0);
+}
+function resolveTagColor(tagName, inputColor) {
+  if (inputColor) {
+    return inputColor;
+  }
+  const normalizedTagName = tagName.trim();
+  if (normalizedTagName.length === 0) {
+    return TAG_COLOR_PALETTE[0];
+  }
+  const colorIndex = hashTagName(normalizedTagName) % TAG_COLOR_PALETTE.length;
+  return TAG_COLOR_PALETTE[colorIndex];
+}
 var TagService = class {
   storage;
   constructor(storage2) {
@@ -564,11 +615,19 @@ var TagService = class {
           code: "DUPLICATE_ERROR"
         };
       }
+      const resolvedColor = resolveTagColor(data.name, data.color);
+      if (!HEX_COLOR_PATTERN.test(resolvedColor)) {
+        return {
+          success: false,
+          error: `Color must be a valid hex code (e.g., #FF5733), received '${resolvedColor}'`,
+          code: "VALIDATION_ERROR"
+        };
+      }
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const tag = {
         id: generateTagId(),
         name: data.name,
-        color: data.color,
+        color: resolvedColor,
         description: data.description || "",
         createdAt: now
       };
@@ -667,6 +726,13 @@ var TagService = class {
           };
         }
       }
+      if (data.color && !HEX_COLOR_PATTERN.test(data.color)) {
+        return {
+          success: false,
+          error: `Color must be a valid hex code (e.g., #FF5733), received '${data.color}'`,
+          code: "VALIDATION_ERROR"
+        };
+      }
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const existingTag = projectData.tags[tagIndex];
       const updatedTag = {
@@ -818,6 +884,10 @@ function calculateCompletedAt(currentStatus, newStatus, existingCompletedAt, now
   }
   return existingCompletedAt;
 }
+function findInvalidTagIds(projectData, tagIds) {
+  const validTagIds = new Set(projectData.tags.map((tag) => tag.id));
+  return tagIds.filter((tagId) => !validTagIds.has(tagId));
+}
 var TaskService = {
   /**
    * Create a new task in a project
@@ -835,6 +905,15 @@ var TaskService = {
           code: "NOT_FOUND"
         };
       }
+      const incomingTagIds = data.tags ?? [];
+      const invalidTagIds = findInvalidTagIds(projectData, incomingTagIds);
+      if (invalidTagIds.length > 0) {
+        return {
+          success: false,
+          error: `Invalid tag IDs for project '${projectId}': ${invalidTagIds.join(", ")}`,
+          code: "VALIDATION_ERROR"
+        };
+      }
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const task = {
         id: generateTaskId(),
@@ -843,7 +922,7 @@ var TaskService = {
         description: data.description,
         status: "todo",
         priority: data.priority ?? "medium",
-        tags: data.tags ?? [],
+        tags: incomingTagIds,
         dueDate: data.dueDate ?? null,
         assignee: data.assignee ?? null,
         createdAt: now,
@@ -936,6 +1015,16 @@ var TaskService = {
           code: "VALIDATION_ERROR"
         };
       }
+      if (data.tags) {
+        const invalidTagIds = findInvalidTagIds(projectData, data.tags);
+        if (invalidTagIds.length > 0) {
+          return {
+            success: false,
+            error: `Invalid tag IDs for project '${projectId}': ${invalidTagIds.join(", ")}`,
+            code: "VALIDATION_ERROR"
+          };
+        }
+      }
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const existingTask = projectData.tasks[taskIndex];
       const completedAt = calculateCompletedAt(
@@ -1067,9 +1156,19 @@ var TaskService = {
           continue;
         }
         const existingTask = projectData.tasks[taskIndex];
-        let updatedTags = existingTask.tags;
-        if (data.tags && data.tags.length > 0) {
-          const existingTags = existingTask.tags || [];
+        let updatedTags = existingTask.tags ?? [];
+        if (data.tags) {
+          const invalidTagIds = findInvalidTagIds(projectData, data.tags);
+          if (invalidTagIds.length > 0) {
+            return {
+              success: false,
+              error: `Invalid tag IDs for project '${projectId}': ${invalidTagIds.join(", ")}`,
+              code: "VALIDATION_ERROR"
+            };
+          }
+        }
+        if (data.tags) {
+          const existingTags = existingTask.tags ?? [];
           switch (data.tagOperation) {
             case "add":
               updatedTags = [.../* @__PURE__ */ new Set([...existingTags, ...data.tags])];
@@ -1147,7 +1246,7 @@ function toTaskSummary2(task) {
 }
 var createTaskTool = {
   name: "create_task",
-  description: "Create a new task in a project. Returns summary by default; set verbose=true for full data.",
+  description: "Create a new task in a project. tags must be existing tag IDs from the same project. Returns summary by default; set verbose=true for full data.",
   inputSchema: z2.object({
     projectId: z2.string().min(1, "Project ID is required"),
     title: z2.string().min(1, "Task title is required"),
@@ -1227,7 +1326,7 @@ var getTaskTool = {
 };
 var updateTaskTool = {
   name: "update_task",
-  description: "Update an existing task. Returns summary by default; set verbose=true for full data.",
+  description: "Update an existing task. tags must be existing tag IDs from the same project. Returns summary by default; set verbose=true for full data.",
   inputSchema: z2.object({
     projectId: z2.string().min(1, "Project ID is required"),
     taskId: z2.string().min(1, "Task ID is required"),
@@ -1270,7 +1369,7 @@ var deleteTaskTool = {
 };
 var batchUpdateTasksTool = {
   name: "batch_update_tasks",
-  description: "Update multiple tasks at once. Returns summaries by default; set verbose=true for full task data.",
+  description: "Update multiple tasks at once. tags must be existing tag IDs from the same project. Returns summaries by default; set verbose=true for full task data.",
   inputSchema: z2.object({
     projectId: z2.string().min(1, "Project ID is required"),
     taskIds: z2.array(z2.string()).min(1, "At least one task ID is required"),
@@ -1304,11 +1403,11 @@ import { z as z3 } from "zod";
 var tagService = new TagService(storage);
 var createTagTool = {
   name: "create_tag",
-  description: "Create a new tag in a project",
+  description: "Create a new tag in a project. If color is omitted, it is generated deterministically from tag name.",
   inputSchema: z3.object({
     projectId: z3.string().min(1, "Project ID is required"),
     name: z3.string().min(1, "Tag name is required"),
-    color: z3.string().regex(/^#[0-9A-Fa-f]{6}$/, "Color must be a valid hex code (e.g., #FF5733)"),
+    color: z3.string().regex(/^#[0-9A-Fa-f]{6}$/, "Color must be a valid hex code (e.g., #FF5733)").optional(),
     description: z3.string().default("")
   }),
   async execute(input) {
@@ -2442,6 +2541,8 @@ function getQuickCapturePrompt(idea, projectId) {
 
 ${projectContext}
 
+## [Non-intrusive task] Pause your current work briefly to complete this quick capture, then let the user know it's done and resume what you were doing.
+
 ## Please complete the following steps immediately:
 
 ### 1. Task Information Extraction
@@ -2462,8 +2563,18 @@ Suggest relevant tags:
 - Priority tags: urgent, important
 - Domain tags: frontend, backend, design, testing (if applicable)
 
+Tag consistency rules:
+- list_tags first, then prefer reusing existing tags in that project
+- If no suitable tag exists, create_tag first (color optional, system can auto-generate) and then use the returned tag ID
+- create_task.tags must contain tag IDs only (not tag names)
+
 ### 4. Create Task
 Use create_task to create the task immediately \u2014 no confirmation needed.
+Before create_task:
+1. Call list_tags(projectId)
+2. Match suggested tags to existing tags by name (case-insensitive)
+3. For missing tags, call create_tag(projectId, name, color?)
+4. Build create_task.tags from tag IDs only
 
 ### 5. Status
 After creating, if work starts immediately, use update_task to set status to in-progress.
@@ -2478,6 +2589,7 @@ After creating, if work starts immediately, use update_task to set status to in-
 - Type: Bug
 - Priority: High (affects user experience)
 - Suggested Tags: bug, frontend, mobile
+- create_task.tags: [existing_or_new_tag_ids]
 - Recommended Project: [Recommend if there's a web project]
 
 ## Current Idea:
@@ -2499,7 +2611,9 @@ function getOpenWebUIPrompt(port) {
         role: "user",
         content: {
           type: "text",
-          text: `Please open the roadmap-skill web interface by calling the open_web_interface tool with port ${portNum}. Do it immediately without asking for confirmation.`
+          text: `**[Non-intrusive task]** Pause your current work briefly to complete this quick action, then let the user know it's done and resume what you were doing.
+
+Call the open_web_interface tool${port ? ` with port ${portNum}` : ""} to launch the roadmap-skill web visualization interface.`
         }
       }
     ]