@codazen/harmonica-mcp 0.22.0 → 0.23.0

package/dist/index.js

@@ -22966,28 +22966,45 @@ function registerDropTools(server, ctx, client) {
   );
   server.tool(
     "get_drop",
-    "Get full details of a Drop by ID \u2014 state, member Revisions, target date, and audit trail.",
+    "Get full details of a Drop by ID \u2014 state, member Revisions, target date, and audit trail. Accepts either a UUID (drop-abc123) or a drop code (D-086). When passing a code, teamspaceId is required.",
     {
-      dropId: external_exports.string().describe("The Drop ID (UUID)")
+      dropId: external_exports.string().describe("The Drop ID (UUID, e.g. drop-abc123) or drop code (e.g. D-086). When passing a code, teamspaceId is required."),
+      teamspaceId: external_exports.string().optional().describe("Required when dropId is a drop code like D-086")
     },
-    async ({ dropId }) => {
-      const d = await client.getDrop(dropId);
-      if (!d) return { content: [{ type: "text", text: `Drop not found: ${dropId}` }], isError: true };
-      const lines = [
-        `ID: ${d.dropId}`,
-        `Code: ${d.dropCode}`,
-        `Name: ${d.name}`,
-        `Teamspace: ${d.teamspaceId}`,
-        `State: ${d.state}`,
-        d.description ? `Description: ${d.description}` : null,
-        d.targetDate ? `Target: ${d.targetDate}` : null,
-        d.releasedAt ? `Released: ${d.releasedAt}` : null,
-        d.rolledBackAt ? `Rolled back: ${d.rolledBackAt}` : null,
-        `Revisions (${d.revisionIds.length}): ${d.revisionIds.length === 0 ? "(none)" : d.revisionIds.join(", ")}`,
-        `Version: ${d.version}`,
-        `Created: ${d.createdAt}`
-      ].filter(Boolean);
-      return { content: [{ type: "text", text: lines.join("\n") }] };
+    async ({ dropId, teamspaceId }) => {
+      try {
+        let resolvedId = dropId;
+        if (/^D-\d+$/i.test(dropId)) {
+          if (!teamspaceId) {
+            return { content: [{ type: "text", text: `teamspaceId is required when dropId is a drop code (e.g. D-086)` }], isError: true };
+          }
+          const normalizedCode = dropId.toUpperCase();
+          const drops = await client.listTeamspaceDrops(teamspaceId, void 0);
+          const match = drops.find((d2) => d2.dropCode.toUpperCase() === normalizedCode);
+          if (!match) return { content: [{ type: "text", text: `Drop not found: ${dropId}` }], isError: true };
+          resolvedId = match.dropId;
+        }
+        const d = await client.getDrop(resolvedId);
+        const notFoundMsg = resolvedId !== dropId ? `Drop not found: ${resolvedId} (code: ${dropId})` : `Drop not found: ${dropId}`;
+        if (!d) return { content: [{ type: "text", text: notFoundMsg }], isError: true };
+        const lines = [
+          `ID: ${d.dropId}`,
+          `Code: ${d.dropCode}`,
+          `Name: ${d.name}`,
+          `Teamspace: ${d.teamspaceId}`,
+          `State: ${d.state}`,
+          d.description ? `Description: ${d.description}` : null,
+          d.targetDate ? `Target: ${d.targetDate}` : null,
+          d.releasedAt ? `Released: ${d.releasedAt}` : null,
+          d.rolledBackAt ? `Rolled back: ${d.rolledBackAt}` : null,
+          `Revisions (${d.revisionIds.length}): ${d.revisionIds.length === 0 ? "(none)" : d.revisionIds.join(", ")}`,
+          `Version: ${d.version}`,
+          `Created: ${d.createdAt}`
+        ].filter(Boolean);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        return { content: [{ type: "text", text: `Failed to get drop: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+      }
     }
   );
   server.tool(
@@ -24398,7 +24415,7 @@ function registerPlanQualityTools(server, ctx, client) {
     "check_plan_quality",
     "Enqueue a Revision plan quality check across 6 dimensions (Scoped, Directional, Testable, Traceable, Assignable, Risk-aware). By default returns a taskId immediately (fire-and-forget) \u2014 use get_task_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline.",
     {
-      revisionId: external_exports.string().describe("The revision ID (e.g., rev-abc123)"),
+      revisionId: external_exports.string().describe("The revision or Beat Version ID (e.g., rev-abc123 or bv-abc123)"),
       projectId: external_exports.string().describe("The project ID"),
       wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
     },
@@ -26708,7 +26725,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.22.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.23.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
   "license": "MIT",
   "bin": {