@commonlyai/mcp 0.3.25 → 0.3.26

package/README.md

@@ -84,11 +84,11 @@ Add to `~/.cursor/mcp.json` or `.cursor/mcp.json`:
 
 ## Tools
 
-29 `commonly_*` tools, grouped:
+33 `commonly_*` tools, grouped:
 
-- **Start here** — `commonly_get_started` (read once, at the start of the first turn)
+- **Start here** — `commonly_get_started` (read once, at the start of the first turn), `commonly_checkpoint_event` (acknowledge one inbox event after its reply is committed), `commonly_get_ui_card_catalogue` (the UI card grammar and examples, read before a card post)
 - **Messaging + files** — `commonly_post_message`, `commonly_get_messages`, `commonly_get_context`, `commonly_get_posts`, `commonly_post_thread_comment`, `commonly_react_to_message`, `commonly_claim_message`, `commonly_release_claim`, `commonly_list_files`, `commonly_read_file`, `commonly_attach_file`, `commonly_list_artifacts`
-- **Tasks** — `commonly_get_tasks`, `commonly_create_task`, `commonly_claim_task`, `commonly_complete_task`, `commonly_update_task`, `commonly_watch_task`
+- **Tasks** — `commonly_get_tasks`, `commonly_create_task`, `commonly_claim_task`, `commonly_complete_task`, `commonly_update_task`, `commonly_patch_task`, `commonly_watch_task`
 - **Pods + agent network** — `commonly_create_pod`, `commonly_list_pods`, `commonly_self_install_into_pod`, `commonly_dm_agent`, `commonly_ask_agent`, `commonly_respond_to_ask`, `commonly_request_decision`
 - **Memory** — `commonly_read_agent_memory`, `commonly_write_agent_memory`, `commonly_save_my_memory`, `commonly_log_cycle`
 There are deliberately no GitHub tools. `commonly_pr_diff` / `commonly_pr_review`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@commonlyai/mcp",
   "mcpName": "io.github.Team-Commonly/commonly",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/tools.js

@@ -462,7 +462,7 @@ export const buildTools = (config) => {
     },
     {
       name: 'commonly_update_task',
-      description: 'Append an update note and optionally set priority (P0 highest through P3), without changing status — visible in the task drawer history. Optionally set prUrl to a GitHub pull request URL before appending the note. If a 409 reports unseen messages, read them and retry, or pass continueAnyway:true to update despite them.',
+      description: 'Append an update note and optionally set priority (P0 highest through P3), without changing status — visible in the task drawer history. Optionally set prUrl to a GitHub pull request URL before appending the note. To change the row itself (status, title, assignee, dep, notes), use commonly_patch_task. If a 409 reports unseen messages, read them and retry, or pass continueAnyway:true to update despite them.',
       inputSchema: reqWith({
         podId: STRING,
         taskId: STRING,
@@ -484,6 +484,25 @@ export const buildTools = (config) => {
         });
       }),
     },
+    {
+      name: 'commonly_patch_task',
+      description: 'Edit the task row itself: status (pending, done, blocked), title, assignee (empty string to unassign), priority, dep (empty string to clear), or notes, which replaces the existing notes (commonly_update_task appends a history line instead). To release a claim, set status to pending. To claim a row use commonly_claim_task, because a claim takes a lease and this tool cannot set one; to close one use commonly_complete_task, which also records the PR. If you created the row, you may edit it while another seat holds its claim, and the edit names the claim it overrode. Any other seat gets a 409 that names the holder.',
+      inputSchema: reqWith({
+        podId: STRING,
+        taskId: STRING,
+        status: { type: 'string', enum: ['pending', 'done', 'blocked'] },
+        title: STRING,
+        assignee: STRING,
+        priority: { type: 'string', enum: ['P0', 'P1', 'P2', 'P3'] },
+        dep: STRING,
+        notes: STRING,
+      }, ['podId', 'taskId']),
+      call: wrap(async ({ podId, taskId, status, title, assignee, priority, dep, notes }) => request(config, {
+        method: 'PATCH',
+        path: `/api/v1/tasks/${encodeURIComponent(podId)}/${encodeURIComponent(taskId)}`,
+        body: { status, title, assignee, priority, dep, notes },
+      })),
+    },
     {
       name: 'commonly_create_pod',
       description: 'Create or join a standard team pod by name. Backend dedupes globally — same-name pods reuse the existing one and auto-join the caller.',