@codazen/harmonica-mcp 0.23.0 → 0.24.0

package/dist/index.js

@@ -24696,24 +24696,35 @@ function registerRevisionLifecycleTools(server, ctx, client) {
       title: external_exports.string().describe("Title for this revision"),
       description: external_exports.string().describe("What this revision delivers"),
       changeSummary: external_exports.string().describe("Brief summary of the change"),
+      beatVersionId: external_exports.string().min(1).optional().describe("Optional Beat Version ID to associate this revision with"),
       tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
       priority: external_exports.coerce.number().optional().describe("Priority (lower = higher priority)"),
       estimatedEffort: external_exports.string().optional().describe("Estimated effort (e.g., S, M, L, XL)"),
       humanAssignee: humanAssigneeSchema.optional().describe('Human assignee (e.g. { email: "mmerchant@codazen.com", name: "Mike Merchant" })'),
       agentAssignee: agentAssigneeSchema.optional().describe('Agent assignee (e.g. { agentId: "maya", name: "Maya" })')
     },
-    async ({ beatId, title, description, changeSummary, tags, priority, estimatedEffort, humanAssignee, agentAssignee }) => {
+    async ({ beatId, title, description, changeSummary, beatVersionId, tags, priority, estimatedEffort, humanAssignee, agentAssignee }) => {
       try {
         await assertBeatInOrg(client, beatId, ctx.orgId);
         const beat = await client.getBeat(beatId);
         if (!beat) {
           return { content: [{ type: "text", text: `Beat not found: "${beatId}"` }], isError: true };
         }
+        if (beatVersionId !== void 0) {
+          const bv = await client.getBeatVersion(beatVersionId);
+          if (!bv) {
+            return { content: [{ type: "text", text: `Beat Version not found: "${beatVersionId}"` }], isError: true };
+          }
+          if (bv.beatId !== beatId || bv.projectId !== beat.projectId) {
+            return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" belongs to a different Beat.` }], isError: true };
+          }
+        }
         const { revision, warnings } = await client.createRevision(beat.projectId, beatId, {
           title,
           description,
           changeSummary,
           changeImportance: "moderate",
+          beatVersionId,
           tags,
           priority,
           estimatedEffort,
@@ -24750,23 +24761,34 @@ function registerRevisionLifecycleTools(server, ctx, client) {
       changeSummary: external_exports.string().describe("Why this change is being made (recorded in audit trail)"),
       title: external_exports.string().optional().describe("New title"),
       description: external_exports.string().optional().describe("New description (what this revision delivers)"),
+      beatVersionId: external_exports.string().min(1).nullable().optional().describe("Beat Version ID to associate \u2014 set null to clear"),
       tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
       priority: external_exports.coerce.number().optional().describe("Priority (lower = higher priority)"),
       estimatedEffort: external_exports.string().optional().describe("Effort estimate (e.g., S, M, L, XL)"),
       humanAssignee: humanAssigneeSchema.nullable().optional().describe("Human assignee \u2014 set null to clear"),
       agentAssignee: agentAssigneeSchema.nullable().optional().describe("Agent assignee \u2014 set null to clear")
     },
-    async ({ revisionId, changeSummary, ...changes }) => {
+    async ({ revisionId, changeSummary, beatVersionId, ...changes }) => {
       try {
         const revision = await client.getRevision(revisionId);
         if (!revision) {
           return { content: [{ type: "text", text: `Revision not found: "${revisionId}"` }], isError: true };
         }
         await assertBeatInOrg(client, revision.beatId, ctx.orgId);
+        if (typeof beatVersionId === "string") {
+          const bv = await client.getBeatVersion(beatVersionId);
+          if (!bv) {
+            return { content: [{ type: "text", text: `Beat Version not found: "${beatVersionId}"` }], isError: true };
+          }
+          if (bv.beatId !== revision.beatId || bv.projectId !== revision.projectId) {
+            return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" belongs to a different Beat.` }], isError: true };
+          }
+        }
         const updates = { changeSummary };
         for (const [k, v] of Object.entries(changes)) {
           if (v !== void 0) updates[k] = v;
         }
+        if (beatVersionId !== void 0) updates.beatVersionId = beatVersionId;
         if (Object.keys(updates).length <= 1) {
           return { content: [{ type: "text", text: "No fields provided to update." }], isError: true };
         }
@@ -24910,37 +24932,29 @@ function registerSnapshotTools(server, ctx, client) {
           isError: true
         };
       }
+      const trimmed = snapshotInput.trim();
+      const importOptions = { targetOrgId: ctx.orgId, targetUserId: ctx.user.userId };
+      if (trimmed.startsWith("https://")) {
+        if (isPrivateHost(trimmed)) {
+          throw new Error("Snapshot URL must point to a public host \u2014 private, link-local, and loopback addresses are not permitted.");
+        }
+        const result2 = await client.importProjectSnapshotFromUrl(trimmed, importOptions);
+        return { content: [{ type: "text", text: formatImportSummary(result2) }] };
+      }
+      if (trimmed.startsWith("http://")) {
+        throw new Error("Snapshot URL must use https:// \u2014 http:// is not permitted.");
+      }
       const snapshotJson = await resolveSnapshotInput(snapshotInput);
       let parsed;
       try {
         parsed = JSON.parse(snapshotJson);
       } catch {
-        const urlHint = snapshotInput.trim().startsWith("https://") ? ` fetched from ${snapshotInput.trim().split("?")[0]}` : "";
-        throw new Error(`Snapshot is not valid JSON${urlHint}. The URL may have returned an error page instead of snapshot data.`);
+        throw new Error("Snapshot is not valid JSON. The content may be corrupted.");
       }
-      assertSnapshotShape(parsed, snapshotInput.trim().startsWith("https://") ? ` fetched from ${snapshotInput.trim().split("?")[0]}` : "");
+      assertSnapshotShape(parsed, "");
       const normalized = normalizeSnapshot(parsed);
-      const result = await client.importProjectSnapshot(normalized, {
-        targetOrgId: ctx.orgId,
-        targetUserId: ctx.user.userId
-      });
-      const summary = [
-        `Imported project: ${result.projectId}`,
-        `  Beats: ${result.counts.beats}`,
-        `  Proposals: ${result.counts.proposals}`,
-        `  Revisions: ${result.counts.revisions}`,
-        `  Activities: ${result.counts.activities}`,
-        `  Questions: ${result.counts.questions}`,
-        `  Notes: ${result.counts.notes}`,
-        `  Tasks: ${result.counts.tasks}`,
-        `  Submissions: ${result.counts.submissions}`,
-        `  PromptLogs: ${result.counts.promptLogs}`
-      ];
-      if (result.errors.length > 0) {
-        summary.push("", `Errors (${result.errors.length}):`);
-        result.errors.forEach((e) => summary.push(`  - ${e}`));
-      }
-      return { content: [{ type: "text", text: summary.join("\n") }] };
+      const result = await client.importProjectSnapshot(normalized, importOptions);
+      return { content: [{ type: "text", text: formatImportSummary(result) }] };
     }
   );
 }
@@ -24969,27 +24983,30 @@ function normalizeSnapshot(raw) {
 }
 async function resolveSnapshotInput(input) {
   const trimmed = input.trim();
-  if (trimmed.startsWith("https://")) {
-    if (isPrivateHost(trimmed)) {
-      throw new Error("Snapshot URL must point to a public host \u2014 private, link-local, and loopback addresses are not permitted.");
-    }
-    let res;
-    try {
-      res = await fetch(trimmed, { redirect: "error", signal: AbortSignal.timeout(3e4) });
-    } catch (err) {
-      throw new Error(`Failed to fetch snapshot URL: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    if (!res.ok) throw new Error(`Failed to fetch snapshot from URL: ${res.status}`);
-    return res.text();
-  }
-  if (trimmed.startsWith("http://")) {
-    throw new Error("Snapshot URL must use https:// \u2014 http:// is not permitted.");
-  }
   if (trimmed.startsWith("/") || trimmed.startsWith("~")) {
     return (0, import_promises.readFile)(trimmed, "utf-8");
   }
   return trimmed;
 }
+function formatImportSummary(result) {
+  const lines = [
+    `Imported project: ${result.projectId}`,
+    `  Beats: ${result.counts.beats}`,
+    `  Proposals: ${result.counts.proposals}`,
+    `  Revisions: ${result.counts.revisions}`,
+    `  Activities: ${result.counts.activities}`,
+    `  Questions: ${result.counts.questions}`,
+    `  Notes: ${result.counts.notes}`,
+    `  Tasks: ${result.counts.tasks}`,
+    `  Submissions: ${result.counts.submissions}`,
+    `  PromptLogs: ${result.counts.promptLogs}`
+  ];
+  if (result.errors.length > 0) {
+    lines.push("", `Errors (${result.errors.length}):`);
+    result.errors.forEach((e) => lines.push(`  - ${e}`));
+  }
+  return lines.join("\n");
+}
 function isPrivateHost(url) {
   let hostname2;
   try {
@@ -26418,6 +26435,7 @@ function createHttpClient(config2) {
       return download;
     },
     importProjectSnapshot: (snapshot, options) => request("POST", "/api/projects/import", { ...snapshot, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
+    importProjectSnapshotFromUrl: (url2, options) => request("POST", "/api/projects/import", { snapshotUrl: url2, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
     // Embedding similarity
     embedProjectEntities: (projectId) => request("POST", `/api/projects/${encodeURIComponent(projectId)}/embeddings/generate`),
     findSimilarNotes: async (noteId, projectId, options) => {
@@ -26725,7 +26743,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.23.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.24.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.23.0",
+  "version": "0.24.0",
   "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
   "license": "MIT",
   "bin": {