@codazen/harmonica-mcp 0.25.1 → 0.25.3

package/dist/index.js

@@ -22602,6 +22602,7 @@ var LIFECYCLE_STATES = [
   "archived",
   "deprecated"
 ];
+var PR_LIFECYCLE_STATES = ["draft", "open"];
 
 // ../../libs/harmonica-services/src/mcp/tools/beat-version-tools.ts
 function registerBeatVersionTools(server, ctx, client) {
@@ -24937,7 +24938,7 @@ function registerRevisionLifecycleTools(server, ctx, client) {
     "Transition a revision to a new lifecycle state (e.g., concept \u2192 plan, build \u2192 deploy \u2192 support).",
     {
       revisionId: external_exports.string().describe("The revision ID (e.g., rev-abc123)"),
-      targetState: external_exports.enum(LIFECYCLE_STATES).describe("The target lifecycle state"),
+      targetState: external_exports.enum([...LIFECYCLE_STATES, ...PR_LIFECYCLE_STATES]).describe("The target lifecycle state"),
       reason: external_exports.string().optional().describe("Why this transition is being made"),
       skipQualityCheck: external_exports.boolean().optional().describe("Skip the quality check guard (for reconciling already-shipped code)"),
       reconcile: external_exports.boolean().optional().describe("Walk through all intermediate forward states automatically. Use for already-shipped work that needs state machine catch-up.")
@@ -25154,11 +25155,14 @@ function registerSnapshotTools(server, ctx, client) {
         "",
         ...versionNote,
         `  Beats: ${snapshot.beats.length}`,
+        `  Beat Versions: ${snapshot.beatVersions?.length ?? 0}`,
         `  Proposals: ${snapshot.proposals.length}`,
         `  Notes: ${snapshot.notes.length}`,
         `  Tasks: ${snapshot.tasks.length}`,
         `  Submissions: ${snapshot.submissions.length}`,
         `  PromptLogs: ${snapshot.promptLogs.length}`,
+        `  Drops: ${snapshot.drops?.length ?? 0}`,
+        `  Deliverables: ${snapshot.deliverables?.length ?? 0}`,
         "",
         "Use import_project_snapshot with this file path to import into another environment."
       ];
@@ -25169,9 +25173,12 @@ function registerSnapshotTools(server, ctx, client) {
     "import_project_snapshot",
     "Import a project snapshot into the current environment. Accepts an S3 presigned URL (https:// only), a file path, or inline JSON. Blocked in production by default.",
     {
-      snapshot: external_exports.string().describe("S3 presigned URL (https://...), file path, or inline JSON string")
+      snapshot: external_exports.string().describe("S3 presigned URL (https://...), file path, or inline JSON string"),
+      targetTeamspaceId: external_exports.string().min(1).optional().describe(
+        "Remap all teamspace references (Drops, Deliverables, Project record) to this teamspace ID in the target environment. Required when the source and target environments use different teamspace UUIDs. When omitted and the snapshot contains Drops or Deliverables, a warning is included in the import summary."
+      )
     },
-    async ({ snapshot: snapshotInput }) => {
+    async ({ snapshot: snapshotInput, targetTeamspaceId }) => {
       const isProduction = process.env.NODE_ENV === "production";
       const importAllowed = process.env.ALLOW_PROJECT_IMPORT === "true";
       if (isProduction && !importAllowed) {
@@ -25184,13 +25191,13 @@ function registerSnapshotTools(server, ctx, client) {
         };
       }
       const trimmed = snapshotInput.trim();
-      const importOptions = { targetOrgId: ctx.orgId, targetUserId: ctx.user.userId };
+      const importOptions = { targetOrgId: ctx.orgId, targetUserId: ctx.user.userId, targetTeamspaceId };
       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) }] };
+        return { content: [{ type: "text", text: formatImportSummary(result2, targetTeamspaceId) }] };
       }
       if (trimmed.startsWith("http://")) {
         throw new Error("Snapshot URL must use https:// \u2014 http:// is not permitted.");
@@ -25205,7 +25212,7 @@ function registerSnapshotTools(server, ctx, client) {
       assertSnapshotShape(parsed, "");
       const normalized = normalizeSnapshot(parsed);
       const result = await client.importProjectSnapshot(normalized, importOptions);
-      return { content: [{ type: "text", text: formatImportSummary(result) }] };
+      return { content: [{ type: "text", text: formatImportSummary(result, targetTeamspaceId) }] };
     }
   );
 }
@@ -25248,7 +25255,7 @@ async function resolveSnapshotInput(input) {
   }
   return trimmed;
 }
-function formatImportSummary(result) {
+function formatImportSummary(result, targetTeamspaceId) {
   const lines = [
     `Imported project: ${result.projectId}`,
     `  Beats: ${result.counts.beats}`,
@@ -25259,12 +25266,24 @@ function formatImportSummary(result) {
     `  Notes: ${result.counts.notes}`,
     `  Tasks: ${result.counts.tasks}`,
     `  Submissions: ${result.counts.submissions}`,
-    `  PromptLogs: ${result.counts.promptLogs}`
+    `  PromptLogs: ${result.counts.promptLogs}`,
+    `  Beat Versions: ${result.counts.beatVersions ?? 0}`,
+    `  Drops: ${result.counts.drops ?? 0}`,
+    `  Deliverables: ${result.counts.deliverables ?? 0}`
   ];
   if (result.errors.length > 0) {
     lines.push("", `Errors (${result.errors.length}):`);
     result.errors.forEach((e) => lines.push(`  - ${e}`));
   }
+  const hasTeamspaceData = result.projectTeamspaceId !== void 0 || (result.counts.drops ?? 0) + (result.counts.deliverables ?? 0) > 0;
+  if (!targetTeamspaceId && hasTeamspaceData) {
+    lines.push(
+      "",
+      "Warning: snapshot contains teamspace-scoped data but targetTeamspaceId was not provided.",
+      "The project record and any Drops or Deliverables were imported with their original teamspaceId and may not appear under the correct teamspace in this environment.",
+      "Re-run with targetTeamspaceId set to the target teamspace UUID to remap them."
+    );
+  }
   return lines.join("\n");
 }
 function isPrivateHost(url) {
@@ -27038,7 +27057,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.25.1"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.25.3"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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