automd-mcp 0.2.1 → 0.2.2

package/dist/index.js

@@ -40506,6 +40506,16 @@ var api = {
     body: JSON.stringify(data)
   }),
   deleteProject: (id) => request(`/api/projects/${id}`, { method: "DELETE" }),
+  // Tags
+  getTags: (projectId) => {
+    const query = new URLSearchParams();
+    if (projectId) query.set("projectId", projectId);
+    return request(`/api/tags?${query.toString()}`);
+  },
+  updateInstanceTags: (tags) => request("/api/tags", {
+    method: "PUT",
+    body: JSON.stringify({ tags })
+  }),
   // Health
   health: () => request("/api/health")
 };
@@ -40605,7 +40615,7 @@ function registerTools(server2) {
   });
   server2.registerTool("add_task", {
     title: "Add Task",
-    description: "Add a new task (## H2 heading) to a column. Content supports inline metadata: @user #label priority:high|medium|low due:YYYY-MM-DD est:4h knowledge:true. Do not include built-by: manually \u2014 use the agentName parameter.",
+    description: "Add a new task (## H2 heading) to a column. Content supports inline metadata: @user #label priority:high|medium|low due:YYYY-MM-DD est:4h knowledge:true. Do not include built-by: manually \u2014 use the agentName parameter. Call list_tags to discover existing labels before inventing new ones.",
     inputSchema: {
       itemId: external_exports.string().describe("The item ID"),
       columnId: external_exports.string().describe("The column ID (found in get_item response columns[].id)"),
@@ -40750,7 +40760,7 @@ function registerTools(server2) {
   });
   server2.registerTool("update_task_metadata", {
     title: "Update Task Metadata",
-    description: "Update a task's metadata (priority, assignees, labels, due date, estimate) without rewriting its content",
+    description: "Update a task's metadata (priority, assignees, labels, due date, estimate) without rewriting its content. Call list_tags to discover existing labels before adding new ones.",
     inputSchema: {
       itemId: external_exports.string().describe("The item ID"),
       taskId: external_exports.string().describe("The task ID"),
@@ -40871,7 +40881,7 @@ function registerTools(server2) {
   });
   server2.registerTool("search_tasks", {
     title: "Search Tasks",
-    description: "Search for tasks across all items by text, assignee, label, or status",
+    description: "Search for tasks across all items by text, assignee, label, or status. Use list_tags to discover valid label values.",
     inputSchema: {
       query: external_exports.string().optional().describe("Text to search for in task content"),
       assignee: external_exports.string().optional().describe("Filter by assignee (without @)"),
@@ -40915,7 +40925,7 @@ function registerTools(server2) {
   });
   server2.registerTool("search_context", {
     title: "Search Context",
-    description: "Search for contextual detail (descriptions, acceptance criteria, learnings) across all items. Returns any task with rich content \u2014 broader than find_knowledge which only returns knowledge:true items. Use this for finding implementation details, past decisions, and context before starting work.",
+    description: "Search for contextual detail (descriptions, acceptance criteria, learnings) across all items. Returns any task with rich content \u2014 broader than find_knowledge which only returns knowledge:true items. Use this for finding implementation details, past decisions, and context before starting work. Use list_tags to discover valid label values.",
     inputSchema: {
       query: external_exports.string().optional().describe("Text to search for across descriptions, AC, learnings, and task content"),
       label: external_exports.string().optional().describe("Filter by label (without #). Also matches #tags inside learnings text."),
@@ -40936,14 +40946,18 @@ function registerTools(server2) {
                 task.content,
                 task.description,
                 task.acceptanceCriteria,
-                task.learnings
+                task.learnings,
+                ...item.meta?.tags ?? []
               ].filter(Boolean).join(" ").toLowerCase();
               let match = true;
               if (q && !searchable.includes(q)) match = false;
               if (label) {
                 const hasLabel = task.metadata.labels.includes(label);
                 const hasInlineLabelTag = searchable.includes(`#${label.toLowerCase()}`);
-                if (!hasLabel && !hasInlineLabelTag) match = false;
+                const hasFrontmatterTag = item.meta?.tags?.some(
+                  (t) => t.toLowerCase() === label.toLowerCase()
+                );
+                if (!hasLabel && !hasInlineLabelTag && !hasFrontmatterTag) match = false;
               }
               const hasContext = task.description || task.acceptanceCriteria || task.learnings;
               if (!hasContext) match = false;
@@ -40974,7 +40988,7 @@ function registerTools(server2) {
   });
   server2.registerTool("list_projects", {
     title: "List Projects",
-    description: "List all projects. Returns array of {id, name, color}. Use project id as projectId in create_item or get_project_items."
+    description: "List all projects with their curated tags. Returns array of {id, name, color, tags}. Use project id as projectId in create_item, get_project_items, or list_tags."
   }, async () => {
     try {
       const projects = await api.listProjects();
@@ -41015,9 +41029,23 @@ function registerTools(server2) {
       return errorResponse(err);
     }
   });
+  server2.registerTool("list_tags", {
+    title: "List Tags",
+    description: "Discover available tags/labels before searching or tagging content. Returns curated tags (defined by humans), project-specific tags, and tags already in use across items. ALWAYS call this before inventing new tags \u2014 reuse existing ones to keep the knowledge base consistent.",
+    inputSchema: {
+      projectId: external_exports.string().optional().describe("Optional project ID to scope tags to a specific project")
+    }
+  }, async ({ projectId }) => {
+    try {
+      const result = await api.getTags(projectId);
+      return json2(result);
+    } catch (err) {
+      return errorResponse(err);
+    }
+  });
   server2.registerTool("add_knowledge", {
     title: "Add Knowledge",
-    description: "Add a knowledge item. Knowledge items are tasks with knowledge:true \u2014 they store decisions, patterns, references, and institutional memory. They reuse the task infrastructure but skip the checkbox/completion workflow.",
+    description: "Add a knowledge item. Knowledge items are tasks with knowledge:true \u2014 they store decisions, patterns, references, and institutional memory. They reuse the task infrastructure but skip the checkbox/completion workflow. Call list_tags first to reuse existing labels.",
     inputSchema: {
       itemId: external_exports.string().describe("The item ID"),
       columnId: external_exports.string().describe("The column ID"),
@@ -41097,7 +41125,7 @@ function registerTools(server2) {
   });
   server2.registerTool("find_knowledge", {
     title: "Find Knowledge",
-    description: "Search specifically for curated knowledge items (knowledge:true) and tasks with captured learnings. Use for institutional decisions, patterns, and reference. For broader task history including descriptions, use search_context instead.",
+    description: "Search specifically for curated knowledge items (knowledge:true) and tasks with captured learnings. Use for institutional decisions, patterns, and reference. For broader task history including descriptions, use search_context instead. Use list_tags to discover valid label values.",
     inputSchema: {
       query: external_exports.string().optional().describe("Text to search for in knowledge items"),
       label: external_exports.string().optional().describe("Filter by label (without #)")
@@ -41120,14 +41148,18 @@ function registerTools(server2) {
                   task.content,
                   task.description,
                   task.acceptanceCriteria,
-                  task.learnings
+                  task.learnings,
+                  ...item.meta?.tags ?? []
                 ].filter(Boolean).join(" ").toLowerCase();
                 if (!searchable.includes(q)) continue;
               }
               if (label) {
                 const hasLabel = task.metadata?.labels?.includes(label);
                 const hasInlineTag = task.learnings?.toLowerCase().includes(`#${label.toLowerCase()}`);
-                if (!hasLabel && !hasInlineTag) continue;
+                const hasFrontmatterTag = item.meta?.tags?.some(
+                  (t) => t.toLowerCase() === label.toLowerCase()
+                );
+                if (!hasLabel && !hasInlineTag && !hasFrontmatterTag) continue;
               }
               results.push({
                 itemId: itemSummary.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "automd-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "MCP server for AutoMD — manage boards, checklists, and pages stored as markdown",
   "type": "module",
   "main": "./dist/index.js",