@rallycry/conveyor-mcp 5.0.1 → 5.0.3

package/README.md

@@ -0,0 +1,102 @@
+# @rallycry/conveyor-mcp
+
+The Conveyor MCP server. It gives a coding agent — Claude Code, Codex, Cursor,
+Windsurf, VS Code, Claude Desktop — direct access to your Conveyor cards,
+plans, chat, tags, and pull requests.
+
+## Get your values
+
+Open **User Settings → Connect your coding agent (MCP)** in the Conveyor web
+app. It generates a token and copies a pre-filled command or config block that
+already carries your API URL, token, and project id. Use that if you can.
+
+To register the server by hand, replace the three placeholders below:
+
+- `<api-url>` — your Conveyor API host.
+- `<user-token>` — your personal token from User Settings. Treat it as a secret.
+- `<project-id>` — the project to work in. Omit this variable for multi-project
+  mode, then pass `projectId` per tool call after calling `list_projects`.
+
+## Install
+
+### Claude Code (CLI)
+
+```bash
+claude mcp remove conveyor -s local 2>/dev/null;
+claude mcp add conveyor -s local \
+  -e CONVEYOR_API_URL=<api-url> \
+  -e CONVEYOR_USER_TOKEN=<user-token> \
+  -e CONVEYOR_PROJECT_ID=<project-id> \
+  -- npx -y @rallycry/conveyor-mcp@latest
+```
+
+The `claude mcp remove` prefix makes the command idempotent. A bare
+`claude mcp add` exits 1 with "already exists in local config" when a `conveyor`
+server is already registered, which blocks a re-paste after a token rotation.
+
+### JSON config (Cursor, Windsurf, VS Code, Claude Desktop)
+
+Merge this into your `mcpServers` block:
+
+```json
+{
+  "mcpServers": {
+    "conveyor": {
+      "command": "npx",
+      "args": ["-y", "@rallycry/conveyor-mcp@latest"],
+      "env": {
+        "CONVEYOR_API_URL": "<api-url>",
+        "CONVEYOR_USER_TOKEN": "<user-token>",
+        "CONVEYOR_PROJECT_ID": "<project-id>"
+      }
+    }
+  }
+}
+```
+
+### TOML config (Codex CLI, `~/.codex/config.toml`)
+
+```toml
+[mcp_servers.conveyor]
+command = "npx"
+args = ["-y", "@rallycry/conveyor-mcp@latest"]
+
+[mcp_servers.conveyor.env]
+CONVEYOR_API_URL = "<api-url>"
+CONVEYOR_USER_TOKEN = "<user-token>"
+CONVEYOR_PROJECT_ID = "<project-id>"
+```
+
+## Environment variables
+
+| Variable                 | Required | Purpose                                                                              |
+| ------------------------ | -------- | ------------------------------------------------------------------------------------ |
+| `CONVEYOR_API_URL`       | yes      | Conveyor API host.                                                                   |
+| `CONVEYOR_USER_TOKEN`    | yes      | Your personal token. `CONVEYOR_PROJECT_TOKEN` is a backwards-compatible alias.        |
+| `CONVEYOR_PROJECT_ID`    | no       | Default project for unqualified tools. Omit it for multi-project mode.                |
+| `CONVEYOR_SUBPROJECT_ID` | no       | Default board. Unqualified `create_task`/`list_tasks`/`search_tasks` target it.       |
+
+## Why `npx -y …@latest`
+
+Every form above launches the server through
+`npx -y @rallycry/conveyor-mcp@latest`, so each start re-resolves the `@latest`
+tag from the registry. Restarting the MCP server picks up newly published
+versions, and there is no upgrade step to remember. The trade-off is a slightly
+slower launch, because npx checks the registry each time.
+
+The `@latest` tag is load-bearing. npx resolves a bare package name against the
+local workspace first, so a bare `npx @rallycry/conveyor-mcp` inside a repo that
+vendors a package of that name execs the unbuilt local copy and the server fails
+to start. A version or tag spec forces registry resolution regardless of cwd.
+Never shorten the command.
+
+## Verify
+
+After you reload MCP servers, call `verify_connection`. It returns a plain
+pass/fail plus, on failure, the failing layer and one next action. Then call
+`get_connection_context` to confirm the account, project, and board are the ones
+you intended.
+
+## License
+
+MIT

package/dist/{chunk-7VH3ULLT.js → chunk-XLDG5QEX.js}

@@ -208,14 +208,13 @@ var ConveyorConnection = class {
     const { projectId, subProjectId, tags, ...rest } = params;
     const resolvedProjectId = this.resolveProjectId(projectId);
     const resolvedSubProjectId = this.resolveSubProjectId(subProjectId);
+    const tagIds = await this.resolveTagIds(resolvedProjectId, tags ?? []);
     const result = await this.call("createProjectTask", {
       projectId: resolvedProjectId,
       subProjectId: resolvedSubProjectId,
       ...rest
     });
-    if (tags && tags.length > 0) {
-      await this.assignTagsToTask(result.id, resolvedProjectId, tags);
-    }
+    await this.assignResolvedTags(result.id, tagIds);
     return {
       ...result,
       effectiveScope: {
@@ -230,12 +229,10 @@ var ConveyorConnection = class {
     const hasCoreUpdate = rest.title !== void 0 || rest.description !== void 0 || rest.plan !== void 0 || rest.status !== void 0 || rest.risk !== void 0 || rest.storyPointValue !== void 0 || rest.assignedUserId !== void 0 || rest.subProjectId !== void 0 || rest.githubBranch !== void 0;
     const removedTags = removeTags ?? [];
     const addedTags = addTags ?? [];
-    if (removedTags.length > 0) {
-      await this.removeTagsFromTask(rest.taskId, resolvedProjectId, removedTags);
-    }
-    if (addedTags.length > 0) {
-      await this.assignTagsToTask(rest.taskId, resolvedProjectId, addedTags);
-    }
+    const removeIds = await this.resolveTagIds(resolvedProjectId, removedTags);
+    const addIds = await this.resolveTagIds(resolvedProjectId, addedTags);
+    await this.removeResolvedTags(rest.taskId, removeIds);
+    await this.assignResolvedTags(rest.taskId, addIds);
     if (hasCoreUpdate) {
       const result = await this.call("updateProjectTask", { projectId: resolvedProjectId, ...rest });
       return { ...result, addedTags, removedTags };
@@ -270,13 +267,11 @@ var ConveyorConnection = class {
     }
     return [...new Set(ids)];
   }
-  async assignTagsToTask(taskId, projectId, names) {
-    const tagIds = await this.resolveTagIds(projectId, names);
+  async assignResolvedTags(taskId, tagIds) {
     if (tagIds.length === 0) return;
     await this.callService("tagService", "assignToTask", { taskId, tagIds });
   }
-  async removeTagsFromTask(taskId, projectId, names) {
-    const tagIds = await this.resolveTagIds(projectId, names);
+  async removeResolvedTags(taskId, tagIds) {
     if (tagIds.length === 0) return;
     await this.callService("tagService", "removeFromTask", { taskId, tagIds });
   }
@@ -552,7 +547,7 @@ var ConveyorConnection = class {
       ...rest
     });
   }
-  // ── Meetings (read-only) ────────────────────────────────────────────
+  // ── Meetings ────────────────────────────────────────────────────────
   listMeetings(params) {
     const { projectId, ...rest } = params;
     return this.call("listMeetings", { projectId: this.resolveProjectId(projectId), ...rest });
@@ -568,6 +563,48 @@ var ConveyorConnection = class {
       ...rest
     });
   }
+  createMeeting(params) {
+    const { projectId, ...rest } = params;
+    return this.call("createProjectMeeting", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
+  updateMeeting(params) {
+    const { projectId, ...rest } = params;
+    return this.call("updateProjectMeeting", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
+  addMeetingChecklistItems(params) {
+    const { projectId, ...rest } = params;
+    return this.call("addProjectMeetingChecklistItems", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
+  checkMeetingChecklistItem(params) {
+    const { projectId, ...rest } = params;
+    return this.call("checkProjectMeetingChecklistItem", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
+  editMeetingChecklistItem(params) {
+    const { projectId, ...rest } = params;
+    return this.call("editProjectMeetingChecklistItem", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
+  removeMeetingChecklistItem(params) {
+    const { projectId, ...rest } = params;
+    return this.call("removeProjectMeetingChecklistItem", {
+      projectId: this.resolveProjectId(projectId),
+      ...rest
+    });
+  }
   /** Effective account/project/board identity + capabilities for this token. */
   getConnectionContext(projectId) {
     return this.call("getConnectionContext", {
@@ -707,13 +744,12 @@ var ConveyorConnection = class {
   async createSubtask(params) {
     const { projectId, tags, ...rest } = params;
     const resolvedProjectId = this.resolveProjectId(projectId);
+    const tagIds = await this.resolveTagIds(resolvedProjectId, tags ?? []);
     const result = await this.call("createProjectSubtask", {
       projectId: resolvedProjectId,
       ...rest
     });
-    if (tags && tags.length > 0) {
-      await this.assignTagsToTask(result.id, resolvedProjectId, tags);
-    }
+    await this.assignResolvedTags(result.id, tagIds);
     return result;
   }
   /**