@ezmodo/mcp-server 0.20.0 → 0.20.1

package/handlers/epics.js

@@ -5,35 +5,18 @@
  * Project-First Hierarchy: Epics belong to projects (required),
  * with optional milestone linking.
  *
- * Auto-assignment: When creating epics, automatically applies matching tags
- * based on content analysis against the local project cache.
+ * Tags: only the tagIds the caller passes are applied, in the create request
+ * itself. Keyword matches against the local project cache come back as
+ * `suggestedTags` (see lib/auto-assign.js for why they are not applied).
  */
 
 import { callZephlyAPI } from '../lib/http-client.js';
 import { resolveEpicAutoAssign } from '../lib/auto-assign.js';
+import { suggestTags } from '../lib/suggested-tags.js';
 import { buildEpicUrl } from '../lib/web-url.js';
-import { getLogger } from '../lib/logger.js';
 import { attachLinks } from '../lib/links-at-create.js';
 import { normalizeChangedFiles } from '../lib/changed-files.js';
 
-/**
- * Apply tags to a newly created entity via bulkTagEntities.
- * Non-fatal — logs errors but doesn't throw.
- */
-async function applyAutoTags(organizationId, entityType, entityId, tagIds) {
-  if (!organizationId || !tagIds?.length || !entityId) return;
-  try {
-    await callZephlyAPI('mcpBulkTagEntities', {
-      organizationId,
-      tagIds,
-      entities: [{ entityType, entityId }],
-      operation: 'add',
-    });
-  } catch (err) {
-    getLogger().warn('Auto-tag failed', { entityType, entityId, error: err.message });
-  }
-}
-
 /**
  * Flatten the nested-task result into the fields an agent acts on (#2247).
  *
@@ -128,7 +111,7 @@ async function createEpic(args) {
 
   // An epic with its breakdown goes to the composing endpoint (#2247) so the
   // whole thing is one request; without tasks nothing changes. Everything below
-  // this line — auto-tags, links, web URL — acts on the EPIC and so is identical
+  // this line — suggested tags, links, web URL — acts on the EPIC and so is identical
   // either way.
   const result = tasks?.length
     ? await callZephlyAPI('mcpCreateEpicWithTasks', {
@@ -143,18 +126,10 @@ async function createEpic(args) {
 
   if (tasks?.length) summarizeNestedTasks(result);
 
-  // Auto-apply matching tags (non-fatal)
-  const autoAssign = await resolveEpicAutoAssign(title, description);
-  if (autoAssign?.matchedTags?.length && result?.epicId) {
-    await applyAutoTags(
-      autoAssign.organizationId,
-      'epic',
-      result.epicId,
-      autoAssign.matchedTags.map((t) => t.id),
-    );
-    result.autoAssigned = {
-      tags: autoAssign.matchedTags.map((t) => t.name),
-    };
+  // Suggest, never apply, keyword-matched tags (#2830).
+  const suggestedTags = suggestTags(await resolveEpicAutoAssign(title, description), createArgs.tagIds);
+  if (suggestedTags.length && result?.epicId) {
+    result.suggestedTags = suggestedTags;
   }
 
   // Attach create-time links (E-225) — best effort, never fails the create.

package/handlers/tasks.js

@@ -7,12 +7,14 @@
  * Code links are derived: the files a task touches (changedFiles / linkedFiles)
  * resolve to the features that own those paths (E-258). Agents name the feature
  * the work advances through `links`.
- * Tags are auto-assigned based on content analysis against the local project cache.
+ * Tags: only the tagIds the caller passes are applied; keyword matches against
+ * the local project cache come back as `suggestedTags` (see lib/auto-assign.js).
  */
 
 import { previewEntityLinks, partitionProposals, attachSuggestionIds } from '../lib/autolink.js';
 import { callZephlyAPI } from '../lib/http-client.js';
 import { resolveTaskAutoAssign } from '../lib/auto-assign.js';
+import { suggestTags } from '../lib/suggested-tags.js';
 import { buildTaskUrl } from '../lib/web-url.js';
 import { getLogger } from '../lib/logger.js';
 import { writeActiveSession, clearActiveSession } from '../lib/active-session.js';
@@ -21,24 +23,6 @@ import { getContext } from './context-manifest.js';
 import { getCommitFiles, getRepositoryRoot } from '../lib/git-helpers.js';
 import { normalizeChangedFiles } from '../lib/changed-files.js';
 
-/**
- * Apply tags to a newly created entity via bulkTagEntities.
- * Non-fatal — logs errors but doesn't throw.
- */
-async function applyAutoTags(organizationId, entityType, entityId, tagIds) {
-  if (!organizationId || !tagIds?.length || !entityId) return;
-  try {
-    await callZephlyAPI('mcpBulkTagEntities', {
-      organizationId,
-      tagIds,
-      entities: [{ entityType, entityId }],
-      operation: 'add',
-    });
-  } catch (err) {
-    getLogger().warn('Auto-tag failed', { entityType, entityId, error: err.message });
-  }
-}
-
 /**
  * Dispatch manage_task actions to the appropriate handler
  */
@@ -154,18 +138,13 @@ async function createTask(args) {
     };
   }
 
-  // Auto-apply tags (non-fatal)
-  const autoAssign = await resolveTaskAutoAssign(projectId, title, description);
-  if (autoAssign?.matchedTags?.length && result?.taskId) {
-    await applyAutoTags(
-      autoAssign.organizationId,
-      'task',
-      result.taskId,
-      autoAssign.matchedTags.map((t) => t.id),
-    );
-    result.autoAssigned = {
-      tags: autoAssign.matchedTags.map((t) => t.name),
-    };
+  // Suggest, never apply, keyword-matched tags (#2830).
+  const suggestedTags = suggestTags(
+    await resolveTaskAutoAssign(projectId, title, description),
+    createArgs.tagIds,
+  );
+  if (suggestedTags.length && result?.taskId) {
+    result.suggestedTags = suggestedTags;
   }
 
   if (autoContext) {

package/lib/auto-assign.js

@@ -1,7 +1,13 @@
 /**
  * Auto-assign Utility
- * Matches task/epic content against cached tags for automatic assignment
- * during creation.
+ * Matches task/epic content against cached tags to SUGGEST tags at creation.
+ *
+ * Suggest-only, deliberately (#2830). The matcher fires on any word in the
+ * title or description, so it proposes tags like "notes" or "docs" on work
+ * that merely mentions them. It never actually applied anything before #2830
+ * (the API side was a stub), so applying its output would have switched on a
+ * noisy behaviour nobody had seen. The agent passes the tags it wants as
+ * `tagIds`; matches come back as `suggestedTags` for it to accept.
  */
 
 import { readConfig } from './local-cache.js';

package/lib/suggested-tags.js

@@ -0,0 +1,21 @@
+/**
+ * Suggested tags (#2830).
+ *
+ * Keyword matches from lib/auto-assign.js are returned to the agent as
+ * `suggestedTags` and never applied; see that file for why.
+ */
+
+/**
+ * Turn keyword matches into the `suggestedTags` a create response carries,
+ * leaving out tags the caller already applied explicitly.
+ *
+ * @param {object|null} autoAssign - Result of resolveTaskAutoAssign / resolveEpicAutoAssign
+ * @param {string[]} [appliedTagIds] - Tag IDs sent with the create
+ * @returns {Array<{id: string, name: string}>}
+ */
+export function suggestTags(autoAssign, appliedTagIds = []) {
+  const applied = new Set(appliedTagIds || []);
+  return (autoAssign?.matchedTags || [])
+    .filter((t) => !applied.has(t.id))
+    .map((t) => ({ id: t.id, name: t.name }));
+}

package/lib/version.js

@@ -7,4 +7,4 @@
  *
  * Update this when bumping the version in package.json.
  */
-export const MCP_VERSION = '0.20.0';
+export const MCP_VERSION = '0.20.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezmodo/mcp-server",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "MCP server for ezmodo - AI-first project management",
   "main": "index.js",
   "type": "module",

package/tools/epics.js

@@ -44,7 +44,8 @@ export const EPIC_TOOLS = [
       'IMPORTANT when creating: Call get_context first for each area the epic covers to discover relevant ' +
       'files and integration points. Include in the description which layers/services are affected and ' +
       'reference specific file paths. Create child tasks that each reference specific files from context queries. ' +
-      'Auto-applies matching tags from cached project context based on content analysis. ' +
+      'Tags: pass the tag IDs you want as tagIds; the response lists keyword-matched tags you did not pass as ' +
+      'suggestedTags, which are NOT applied — add any that fit with an update. ' +
       'To align an epic to an organization goal, link it to a milestone that is linked to that goal ' +
       '(set milestoneId) — epics have no direct goal field. ' +
       'BREAKING DOWN A FEATURE: pass the child tasks in the `tasks` array on create and the epic and its ' +
@@ -146,10 +147,11 @@ export const EPIC_TOOLS = [
             name: { type: 'string' },
           },
         },
-        labels: {
+        tagIds: {
           type: 'array',
           items: { type: 'string' },
-          description: 'Array of label names',
+          description: 'Tag IDs for categorization (get them from get_current_project_context). ' +
+            'Used by create and update; on update this REPLACES the set.',
         },
         color: {
           type: 'string',