@elitedcs/ghl-mcp 3.34.10 → 3.35.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 3.35.0 — `create_social_post` is now draft-first (closes the silent "everything published at once" trap)
+
+**Behavior change.** `create_social_post` no longer defers go-live to GoHighLevel's
+server-side default. Before, when `status` was omitted the field was dropped from the
+request and GHL decided whether the post went live — an undocumented default that, in
+a loop, is exactly the "all posts fired at once, no error, no warning" failure operators
+hit. The most expensive failures are the silent ones, so the tool now takes a defensive
+stance by default.
+
+- **Draft-first default.** Omit `status` and the post is created as a `draft` (editable,
+  never live). Going live is now an explicit choice (`status:"published"`).
+- **Scheduling is coupled to status.** Pass `scheduledAt` with no `status` and it
+  auto-resolves to `"scheduled"`. Pass `scheduledAt` alongside any *other* status, or
+  `status:"scheduled"` with no `scheduledAt`, and the call is rejected with an actionable
+  error instead of silently publishing now or falling back to the server default. This
+  kills the "I thought it was scheduled" class of failure (CHANGELOG 3.18.0 always
+  required both fields; nothing enforced the pairing until now).
+- Logic extracted to the pure, tested `resolvePostStatus(status, scheduledAt)` helper;
+  tool and field descriptions updated to document the contract. 5 regression tests added.
+- **Migration:** any caller that relied on an un-statused post going live must now pass
+  `status:"published"` explicitly. No other tool is affected.
+
 ## 3.34.10 — `get_free_slots` accepts ISO dates; `update_form` name fallback for fresh forms
 
 Two small fixes that close rough edges found while live-verifying v3.34.9 through

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.34.10",
+      version: "3.35.0",
       mcpName: "io.github.drjerryrelth/ghl-command",
       description: "GoHighLevel MCP Server for Claude. 218 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
@@ -4054,6 +4054,21 @@ function registerMediaTools(server2, client) {
 
 // src/tools/social-planner.ts
 var import_zod21 = require("zod");
+function resolvePostStatus(status, scheduledAt) {
+  if (scheduledAt !== void 0 && status !== void 0 && status !== "scheduled") {
+    throw new Error(
+      `create_social_post: scheduledAt was provided but status is "${status}". A scheduled post requires status:"scheduled" (or omit status to auto-schedule).`
+    );
+  }
+  if (status === "scheduled" && scheduledAt === void 0) {
+    throw new Error(
+      'create_social_post: status:"scheduled" requires scheduledAt (an ISO publish time).'
+    );
+  }
+  if (status !== void 0) return status;
+  if (scheduledAt !== void 0) return "scheduled";
+  return "draft";
+}
 function registerSocialPlannerTools(server2, client) {
   safeTool(
     server2,
@@ -4125,7 +4140,7 @@ function registerSocialPlannerTools(server2, client) {
   safeTool(
     server2,
     "create_social_post",
-    "Create a new social media post",
+    'Create a social media post. Defaults to a draft (never publishes live) unless you pass status explicitly. To schedule, pass scheduledAt and the status auto-resolves to "scheduled". To post immediately, pass status:"published".',
     {
       locationId: import_zod21.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)"),
       accountIds: import_zod21.z.array(import_zod21.z.string()).describe("Array of social account IDs to post to"),
@@ -4133,8 +4148,12 @@ function registerSocialPlannerTools(server2, client) {
       summary: import_zod21.z.string().optional().describe("The post text/caption"),
       media: import_zod21.z.array(import_zod21.z.string()).optional().describe("Array of media URLs to attach"),
       type: import_zod21.z.enum(["post", "story", "reel"]).optional().describe("Post type (default post)"),
-      status: import_zod21.z.enum(["in_review", "scheduled", "draft", "published"]).optional().describe("Post status"),
-      scheduledAt: import_zod21.z.string().optional().describe("Scheduled publish time (ISO string)"),
+      status: import_zod21.z.enum(["in_review", "scheduled", "draft", "published"]).optional().describe(
+        'Post status. Omit to default to "draft" (safe \u2014 never goes live). Use "published" to post immediately, "scheduled" (with scheduledAt) to schedule, or "in_review" for an approval queue.'
+      ),
+      scheduledAt: import_zod21.z.string().optional().describe(
+        'Scheduled publish time (ISO string). When set, status auto-resolves to "scheduled" if you omit it; passing any other status alongside scheduledAt is rejected.'
+      ),
       tags: import_zod21.z.array(import_zod21.z.string()).optional().describe("Tags for the post"),
       ogData: import_zod21.z.object({
         title: import_zod21.z.string().optional(),
@@ -4172,7 +4191,7 @@ function registerSocialPlannerTools(server2, client) {
         };
         body.media = media.map((url) => ({ url, type: mimeFor(url) }));
       }
-      if (status !== void 0) body.status = status;
+      body.status = resolvePostStatus(status, scheduledAt);
       if (scheduledAt !== void 0) body.scheduleDate = scheduledAt;
       if (tags !== void 0) body.tags = tags;
       if (ogData !== void 0) body.ogData = ogData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.34.10",
+  "version": "3.35.0",
   "mcpName": "io.github.drjerryrelth/ghl-command",
   "description": "GoHighLevel MCP Server for Claude. 218 tools — full CRM, automation, marketing control, account-wide workflow audit, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",