@codazen/harmonica-mcp 0.30.0 → 0.31.0

package/dist/index.js

@@ -22877,20 +22877,98 @@ function registerCheckTools(server, ctx, client) {
   );
   server.tool(
     "list_checks",
-    "List persisted checks for a project, beat, or revision. Shows score trends over time. Filter by check type.",
+    "List persisted checks for a project, beat, beat version, or revision. Shows score trends over time. Filter by check type.",
     {
       projectId: external_exports.string().describe("The project ID"),
       beatId: external_exports.string().optional().describe("List checks for this specific beat"),
+      beatVersionId: external_exports.string().optional().describe("List checks for this specific beat version"),
       revisionId: external_exports.string().optional().describe("List checks for this specific revision"),
       checkType: external_exports.enum(["beat_quality", "plan_quality", "build_quality", "pii_scan", "portfolio_coherence"]).optional().describe("Filter by check type")
     },
-    async ({ projectId, beatId, revisionId, checkType }) => {
+    async ({ projectId, beatId, beatVersionId, revisionId, checkType }) => {
       try {
+        const filters = [
+          revisionId ? "revisionId" : null,
+          beatVersionId ? "beatVersionId" : null,
+          beatId ? "beatId" : null
+        ].filter(Boolean);
+        if (filters.length > 1) {
+          return {
+            content: [{
+              type: "text",
+              text: `Only one of revisionId, beatVersionId, beatId may be supplied (got: ${filters.join(", ")}). Pick the target scope and resend.`
+            }],
+            isError: true
+          };
+        }
+        if (revisionId) {
+          if (revisionId.startsWith("bv-")) {
+            return {
+              content: [{
+                type: "text",
+                text: "revisionId must start with 'rev-', got a Beat Version ID (bv-prefix). Use beatVersionId parameter instead."
+              }],
+              isError: true
+            };
+          }
+          if (!revisionId.startsWith("rev-")) {
+            return {
+              content: [{
+                type: "text",
+                text: `revisionId must start with 'rev-', got '${revisionId}'. Pass the full Revision UUID (rev-xxxxxxxx-...).`
+              }],
+              isError: true
+            };
+          }
+        }
+        if (beatVersionId) {
+          if (beatVersionId.startsWith("rev-")) {
+            return {
+              content: [{
+                type: "text",
+                text: "beatVersionId must start with 'bv-', got a Revision ID (rev-prefix). Use revisionId parameter instead."
+              }],
+              isError: true
+            };
+          }
+          if (!beatVersionId.startsWith("bv-")) {
+            return {
+              content: [{
+                type: "text",
+                text: `beatVersionId must start with 'bv-', got '${beatVersionId}'. Pass the full Beat Version UUID (bv-xxxxxxxx-...).`
+              }],
+              isError: true
+            };
+          }
+        }
+        if (beatId) {
+          if (beatId.startsWith("rev-")) {
+            return {
+              content: [{
+                type: "text",
+                text: "beatId must not be a Revision ID (rev-prefix). Use revisionId parameter instead."
+              }],
+              isError: true
+            };
+          }
+          if (beatId.startsWith("bv-")) {
+            return {
+              content: [{
+                type: "text",
+                text: "beatId must not be a Beat Version ID (bv-prefix). Use beatVersionId parameter instead."
+              }],
+              isError: true
+            };
+          }
+        }
         let checks;
         let scope;
         if (revisionId) {
           checks = await client.listRevisionChecks(revisionId, projectId, checkType);
           scope = `revision ${revisionId}`;
+        } else if (beatVersionId) {
+          checks = await client.listBeatVersionChecks(beatVersionId, projectId, checkType);
+          scope = `beat_version ${beatVersionId}`;
         } else if (beatId) {
           checks = await client.listBeatChecks(beatId, projectId, checkType);
           scope = `beat ${beatId}`;
@@ -27450,6 +27528,14 @@ function createHttpClient(config2) {
       );
       return res.checks;
     },
+    listBeatVersionChecks: async (beatVersionId, projectId, checkType) => {
+      const qs = checkType ? `?type=${encodeURIComponent(checkType)}` : "";
+      const res = await request(
+        "GET",
+        `/api/projects/${encodeURIComponent(projectId)}/beat-versions/${encodeURIComponent(beatVersionId)}/checks${qs}`
+      );
+      return res.checks;
+    },
     listDropChecks: async (dropId, _projectId, checkType) => {
       const qs = checkType ? `?type=${encodeURIComponent(checkType)}` : "";
       const res = await request(
@@ -27697,7 +27783,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.30.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.31.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.30.0",
+  "version": "0.31.0",
   "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
   "license": "MIT",
   "bin": {