Feature/manage-task-updates-tool Consolidate Item Update Tools, Add Delete Operation

[TantanLight]

Key Changes

1. Removal of Deprecated CreateUpdateTool

   • File create-update-tool.ts deleted.
   • References removed from platform-api-tools/index.ts.
   • Creation functionality is now handled by ManageItemUpdatesTool.

2. Enhancement of ManageItemUpdatesTool

   • Now supports a unified interface for fetching, creating, and deleting item updates.
   • Schema update:
     • operation enum includes 'fetch', 'create', and 'delete'.
     • boardId and itemId are now always arrays (if provided), never single numbers.
     • updateId field added for delete operation.
   • Logic update:
     • execute method handles all three operations.
     • Internal helpers and logic expect arrays for IDs.
   • Documentation update:
     • JSDoc and example usage updated to reflect array input requirements and new delete capability.
     • README updated to clarify usage and array input requirements.
   • Console output:
     • All console.warn and console.error calls removed to prevent protocol/logging issues with MCP.

3. GraphQL (queries.graphql.ts)

   • Added deleteUpdate mutation.
   • Ran yarn codegen to generate corresponding types.

4. Tests (manage-item-updates-tool.test.ts)

   • Added comprehensive unit tests for the new delete operation.
   • Updated all tests to use arrays for itemId and boardId.
   • All (12) tests pass.

---

Impact

• Provides a single, unified tool (ManageItemUpdatesTool) for fetching, creating, and deleting item updates.
• Reduces code redundancy and improves maintainability.
• Standardizes the interface for all item/board ID inputs, making the tool more predictable and easier to use programmatically.
• Ensures all documentation and tests are consistent with the new input requirements.

---

How to Use

• To fetch updates for a board:

  { boardId: [8102196205], operation: 'fetch' }

• To fetch updates for an item:

  { itemId: [8102197290], operation: 'fetch' }

• To create or delete updates, always provide itemId as an array with a single value.

---

Note:

• Restart local MCP server to load the updated tool schema for ManageItemUpdatesTool.
• Made with Cursor

[dipesh-zangoh]

Merge it? I got need of deleteUpdate mutation today.
Temporarily did manually by js fetch code.