@diviops/mcp-server 1.5.10 → 1.5.12

package/dist/preset-cli/write-path.js

@@ -0,0 +1,110 @@
+/**
+ * Apply-mode write path for the preset-emitter CLI.
+ *
+ * Reuses the existing server WP-client conventions:
+ *  - `WP_URL` / `WP_USER` / `WP_APP_PASSWORD` env vars.
+ *  - `WPClient` from `wp-client.ts` for the HTTP + Basic-Auth machinery.
+ *  - `WPClient.handshake()` for the plugin capability map.
+ *
+ * Before any write the CLI verifies the plugin handshake reports the
+ * `storage_multipath_probe_v1` capability (the storage-path capability
+ * contract, shipped in plugin 1.4.9). Absent → fail fast, before composing
+ * a write.
+ *
+ * `--dry-run` never reaches this module: it requires no credentials, no
+ * handshake, and no network.
+ */
+import { WPClient } from "../wp-client.js";
+import { buildPresetCreateBody } from "./button-emitter.js";
+import { buildHeadingFontPresetCreateBody } from "./heading-font-emitter.js";
+/** The plugin capability the storage-path capability contract ships. */
+export const STORAGE_CAPABILITY = "storage_multipath_probe_v1";
+/** The REST route the CLI posts to — same route `diviops_preset_create` uses. */
+export const PRESET_CREATE_ROUTE = "/preset/create";
+export class CredentialsMissingError extends Error {
+    constructor(missing) {
+        super(`Apply mode requires WordPress credentials. Missing: ${missing.join(", ")}. ` +
+            `Set WP_URL / WP_USER / WP_APP_PASSWORD (the same env vars the MCP server uses). ` +
+            `Use --dry-run to compose preset JSON without credentials.`);
+        this.name = "CredentialsMissingError";
+    }
+}
+export class CapabilityMissingError extends Error {
+    capability;
+    pluginVersion;
+    constructor(capability, pluginVersion) {
+        super(`The active diviops-agent plugin (version ${pluginVersion}) does not report ` +
+            `the "${capability}" capability required for storage-routed preset writes. ` +
+            `Upgrade diviops-agent to a version that ships the "${capability}" capability ` +
+            `(plugin 1.4.9 or later).`);
+        this.capability = capability;
+        this.pluginVersion = pluginVersion;
+        this.name = "CapabilityMissingError";
+    }
+}
+/** Build a `WPClient` from the standard env vars, or throw if any are absent. */
+export function buildClientFromEnv(env = process.env) {
+    const url = env.WP_URL ?? "";
+    const user = env.WP_USER ?? "";
+    const pass = env.WP_APP_PASSWORD ?? "";
+    const missing = [];
+    if (!url)
+        missing.push("WP_URL");
+    if (!user)
+        missing.push("WP_USER");
+    if (!pass)
+        missing.push("WP_APP_PASSWORD");
+    if (missing.length > 0)
+        throw new CredentialsMissingError(missing);
+    return new WPClient({
+        siteUrl: url,
+        username: user,
+        applicationPassword: pass,
+    });
+}
+/**
+ * Verify the plugin handshake reports `storage_multipath_probe_v1`.
+ * Throws `CapabilityMissingError` if absent. Returns the handshake result
+ * so callers can surface the plugin version.
+ */
+export async function assertStorageCapability(client, serverVersion) {
+    const hs = await client.handshake(serverVersion);
+    if (!hs.capabilities || hs.capabilities[STORAGE_CAPABILITY] !== true) {
+        throw new CapabilityMissingError(STORAGE_CAPABILITY, hs.plugin_version ?? "unknown");
+    }
+    return hs;
+}
+/**
+ * Apply a button preset: capability-gate, then POST to `/preset/create`.
+ *
+ * The capability check runs BEFORE the write. The write goes through the
+ * existing storage-routed route — no plugin route is added here.
+ */
+export async function applyButtonPreset(client, entry, opts) {
+    await assertStorageCapability(client, opts.serverVersion);
+    const body = buildPresetCreateBody(entry, { dry_run: opts.dry_run });
+    return client.requestEnveloped(PRESET_CREATE_ROUTE, {
+        method: "POST",
+        body,
+    });
+}
+/**
+ * Apply a `divi/font` heading group preset: capability-gate, then POST
+ * to `/preset/create`. Mirrors `applyButtonPreset`'s sequence — the
+ * capability check runs BEFORE the write, and the write reuses the
+ * existing storage-routed route (no plugin route is added).
+ *
+ * The `pattern_variant` metadata is intentionally NOT in the wire body —
+ * variant selection is a client-side registry-gate decision and the
+ * server route accepts only the standard preset-create fields.
+ */
+export async function applyHeadingFontPreset(client, entry, opts) {
+    await assertStorageCapability(client, opts.serverVersion);
+    const body = buildHeadingFontPresetCreateBody(entry, {
+        dry_run: opts.dry_run,
+    });
+    return client.requestEnveloped(PRESET_CREATE_ROUTE, {
+        method: "POST",
+        body,
+    });
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@diviops/mcp-server",
-  "version": "1.5.10",
+  "version": "1.5.12",
   "description": "MCP server exposing Divi 5 Visual Builder as tools for Claude",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "diviops-mcp": "dist/index.js"
+    "diviops-mcp": "dist/index.js",
+    "diviops-preset": "dist/preset-cli/bin.js"
   },
   "files": [
     "dist",
@@ -18,6 +19,7 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
+    "test": "npm run build && node --test \"dist/preset-cli/__tests__/*.test.js\"",
     "prepublishOnly": "npm run build",
     "regen:skill": "node scripts/regen-module-formats.mjs"
   },