@codazen/harmonica-mcp 0.25.2 → 0.25.4

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) {
@@ -24811,7 +24812,7 @@ function registerProjectTools(server, ctx, client) {
 function registerRevisionLifecycleTools(server, ctx, client) {
   server.tool(
     "create_revision",
-    "Create a new revision on a Beat. Starts at planning status. Use this to add revisions alongside existing ones \u2014 no idempotency guard.",
+    "Create a new revision on a Beat. Starts in `draft` state under the PR workflow (draft \u2192 open \u2192 merged) \u2014 NOT the standard Beat Version lifecycle. Transition to `open` when the PR is ready for review; transition to `merged` when the PR is merged. Environment progression (in_staging, ready_for_production, live) is tracked on the parent Beat Version, not the Revision. Use this to add revisions alongside existing ones \u2014 no idempotency guard.",
     {
       beatId: external_exports.string().describe("The beat ID to create the revision on"),
       title: external_exports.string().describe("Title for this revision"),
@@ -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.")
@@ -26451,6 +26452,9 @@ function createHttpClient(config2) {
             metadata: options.metadata
           }
         );
+        if (raw === void 0) {
+          return { success: false, error: { code: "REVISION_NOT_FOUND", message: "Revision not found" } };
+        }
         return {
           success: true,
           previousState: raw.transition.previousState,
@@ -26458,8 +26462,7 @@ function createHttpClient(config2) {
         };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        const code = err instanceof ApiError && err.status === 404 ? "REVISION_NOT_FOUND" : "TRANSITION_FAILED";
-        return { success: false, error: { code, message } };
+        return { success: false, error: { code: "TRANSITION_FAILED", message } };
       }
     },
     reconcileRevisionToState: async (revisionId, targetState, options) => {
@@ -26951,15 +26954,24 @@ function createHttpClient(config2) {
       return request("PATCH", `/api/beat-versions/${encodeURIComponent(beatVersionId)}`, updates);
     },
     transitionBeatVersionStatus: async (beatVersionId, targetState, options) => {
-      return request("PATCH", `/api/beat-versions/${encodeURIComponent(beatVersionId)}/status`, {
-        status: targetState,
-        reason: options.reason,
-        trigger: options.trigger,
-        actorType: options.actor.type,
-        actorId: options.actor.id,
-        actorName: options.actor.name,
-        metadata: options.metadata
-      });
+      try {
+        const res = await request("PATCH", `/api/beat-versions/${encodeURIComponent(beatVersionId)}/status`, {
+          status: targetState,
+          reason: options.reason,
+          trigger: options.trigger,
+          actorType: options.actor.type,
+          actorId: options.actor.id,
+          actorName: options.actor.name,
+          metadata: options.metadata
+        });
+        if (res === void 0) {
+          return { success: false, error: { code: "BEAT_VERSION_NOT_FOUND", message: "Beat version not found" } };
+        }
+        return { success: true };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: "TRANSITION_FAILED", message } };
+      }
     },
     getBeatVersionAvailableTransitions: async (beatVersionId, actorType) => {
       const qs = actorType ? `?actorType=${encodeURIComponent(actorType)}` : "";
@@ -27056,7 +27068,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.25.2"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.25.4"} 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.2",
+  "version": "0.25.4",
   "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
   "license": "MIT",
   "bin": {