@diviops/mcp-server 1.5.11 → 1.5.13

package/README.md

@@ -85,18 +85,36 @@ See [server-reference.md](../docs/server-reference.md) for per-tool descriptions
 The package also ships a standalone command-line preset emitter, `diviops-preset`,
 that produces byte-canonical Divi 5.5.x preset JSON gated by the verified-attrs
 registry (`data/verified-attrs.json`). It is independent of the MCP stdio server —
-run it directly:
+run it directly. Current commands:
+
+| Command | Emits |
+|---|---|
+| `diviops-preset button [options]` | `divi/button` group preset |
+| `diviops-preset heading-font [options]` | `divi/font` group preset for `divi/heading` (Pattern A — Google Fonts — or Pattern B — local-hosted) |
+| `diviops-preset text-body-font [options]` | `divi/font-body` group preset for `divi/text` — **Pattern A (Google Fonts) only**; Pattern B for body-text has no registered canonical shape and is refused |
 
 ```bash
 diviops-preset button --name "Primary" --bg-color gcid-primary-color \
   --bg-color-hover gcid-secondary-color --radius 8px \
   --font-family Inter --font-weight 600 --font-color gcid-body-color
+
+diviops-preset heading-font --name "Heading H1" --pattern google \
+  --font-family Inter --font-weight 700 \
+  --font-color gcid-heading-color --font-size 48px
+
+diviops-preset text-body-font --name "Body Text" --pattern google \
+  --font-family Inter --font-weight 400 \
+  --font-color gcid-body-color --font-size 16px
 ```
 
 `--dry-run` (the default) composes and prints the canonical JSON with no
 credentials and no network. `--apply` posts to the existing `/preset/create`
 REST route, reusing the same `WP_URL` / `WP_USER` / `WP_APP_PASSWORD` env vars.
-The current scope is one emitter — `divi/button` group presets. See the
+
+The CLI's coverage is intentionally narrow: only the (module, group, variant)
+combinations whose canonical shape is VB-verified in the registry are
+emittable. It is **not** an all-module or all-font-family emitter — each
+additional vertical slice lands with its own verified evidence. See the
 [preset-cli reference](https://github.com/oaris-dev/diviops/blob/main/diviops-server/src/preset-cli/README.md)
 for the full command reference (the `src/` tree is not part of the published
 npm package — this link resolves on the repository).

package/dist/preset-cli/__tests__/cli.test.js

@@ -39,6 +39,14 @@ test("unknown command exits 1 (invalid input)", async () => {
     assert.equal(code, EXIT.INVALID_INPUT);
     assert.match(io.stderr.join("\n"), /Unknown command/);
 });
+test("--help advertises the heading-font command", async () => {
+    const io = capture();
+    const code = await run(["--help"], io);
+    assert.equal(code, EXIT.OK);
+    const help = io.stdout.join("\n");
+    assert.match(help, /heading-font/);
+    assert.match(help, /--pattern <google\|local>/);
+});
 test("unknown flag exits 1 (invalid input)", async () => {
     const io = capture();
     const code = await run(["button", "--name", "X", "--bogus", "y"], io);
@@ -138,6 +146,383 @@ test("parseArgs: --radius-sync rejects values outside on|off", () => {
     const parsed = parseArgs(["button", "--name", "P", "--radius-sync", "maybe"]);
     assert.throws(() => buildButtonInput(parsed), /radius-sync must be/);
 });
+// ------------------------------------------------------------------
+// heading-font command — CLI integration (parse → emit → dry-run JSON)
+// ------------------------------------------------------------------
+test("heading-font dry-run (Pattern A) emits canonical JSON, exit 0", async () => {
+    const io = capture();
+    const code = await run([
+        "heading-font",
+        "--name",
+        "H1",
+        "--pattern",
+        "google",
+        "--font-family",
+        "Inter",
+        "--font-weight",
+        "700",
+        "--font-color",
+        "gcid-heading-color",
+        "--font-size",
+        "48px",
+    ], io);
+    assert.equal(code, EXIT.OK);
+    const parsed = JSON.parse(io.stdout.join("\n"));
+    assert.equal(parsed.type, "group");
+    assert.equal(parsed.dry_run, true);
+    assert.equal(parsed.module_name, "divi/heading");
+    assert.equal(parsed.group_name, "divi/font");
+    assert.equal(parsed.group_id, "designTitleText");
+    const value = parsed.attrs.title.decoration.font.font.desktop.value;
+    assert.equal(value.family, "Inter");
+    assert.equal(value.weight, "700");
+    assert.equal(value.size, "48px");
+    assert.equal(value.color, '$variable({"type":"color","value":{"name":"gcid-heading-color","settings":{}}})$');
+});
+test("heading-font dry-run (Pattern B) emits no `weight` key", async () => {
+    const io = capture();
+    const code = await run([
+        "heading-font",
+        "--name",
+        "H1-local",
+        "--pattern",
+        "local",
+        "--font-family",
+        "Sora 700",
+        "--font-color",
+        "gcid-heading-color",
+        "--font-size",
+        "48px",
+    ], io);
+    assert.equal(code, EXIT.OK);
+    const parsed = JSON.parse(io.stdout.join("\n"));
+    const value = parsed.attrs.title.decoration.font.font.desktop.value;
+    assert.equal(value.family, "Sora 700");
+    assert.equal("weight" in value, false, "Pattern B emits no weight key");
+});
+test("heading-font without --pattern exits 1 (invalid input)", async () => {
+    const io = capture();
+    const code = await run([
+        "heading-font",
+        "--name",
+        "H1",
+        "--font-family",
+        "Inter",
+        "--font-weight",
+        "700",
+    ], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /--pattern/);
+    assert.match(io.stderr.join("\n"), /google\|local/);
+});
+test("heading-font without --name exits 1", async () => {
+    const io = capture();
+    const code = await run(["heading-font", "--pattern", "google", "--font-family", "Inter"], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /requires --name/);
+});
+test("heading-font --pattern local + --font-weight is refused (exit 1)", async () => {
+    const io = capture();
+    const code = await run([
+        "heading-font",
+        "--name",
+        "H1-bad",
+        "--pattern",
+        "local",
+        "--font-family",
+        "Sora 700",
+        "--font-weight",
+        "700",
+    ], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /Pattern B/);
+});
+test("heading-font --pattern with an invalid value exits 1", async () => {
+    const io = capture();
+    const code = await run([
+        "heading-font",
+        "--name",
+        "H1",
+        "--pattern",
+        "auto",
+        "--font-family",
+        "Inter",
+    ], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /--pattern must be/);
+});
+test("heading-font dry-run requires no credentials and no network", async () => {
+    // Mirrors the dry-run-no-creds button assertion: a heading-font dry-run
+    // must not throw a CredentialsMissingError. Exercises AC: --apply is
+    // the only path that touches credentials/handshake/network.
+    const saved = {
+        WP_URL: process.env.WP_URL,
+        WP_USER: process.env.WP_USER,
+        WP_APP_PASSWORD: process.env.WP_APP_PASSWORD,
+    };
+    delete process.env.WP_URL;
+    delete process.env.WP_USER;
+    delete process.env.WP_APP_PASSWORD;
+    try {
+        const io = capture();
+        const code = await run([
+            "heading-font",
+            "--name",
+            "H1",
+            "--pattern",
+            "google",
+            "--font-family",
+            "Inter",
+        ], io);
+        assert.equal(code, EXIT.OK);
+        assert.equal(io.stderr.length, 0, "no error output on credential-free dry-run");
+    }
+    finally {
+        if (saved.WP_URL !== undefined)
+            process.env.WP_URL = saved.WP_URL;
+        if (saved.WP_USER !== undefined)
+            process.env.WP_USER = saved.WP_USER;
+        if (saved.WP_APP_PASSWORD !== undefined)
+            process.env.WP_APP_PASSWORD = saved.WP_APP_PASSWORD;
+    }
+});
+test("heading-font --apply without credentials exits 1 with a credentials hint", async () => {
+    const saved = {
+        WP_URL: process.env.WP_URL,
+        WP_USER: process.env.WP_USER,
+        WP_APP_PASSWORD: process.env.WP_APP_PASSWORD,
+    };
+    delete process.env.WP_URL;
+    delete process.env.WP_USER;
+    delete process.env.WP_APP_PASSWORD;
+    try {
+        const io = capture();
+        const code = await run([
+            "heading-font",
+            "--name",
+            "H1",
+            "--pattern",
+            "google",
+            "--font-family",
+            "Inter",
+            "--apply",
+        ], io);
+        assert.equal(code, EXIT.INVALID_INPUT);
+        assert.match(io.stderr.join("\n"), /requires WordPress credentials/);
+    }
+    finally {
+        if (saved.WP_URL !== undefined)
+            process.env.WP_URL = saved.WP_URL;
+        if (saved.WP_USER !== undefined)
+            process.env.WP_USER = saved.WP_USER;
+        if (saved.WP_APP_PASSWORD !== undefined)
+            process.env.WP_APP_PASSWORD = saved.WP_APP_PASSWORD;
+    }
+});
+// ------------------------------------------------------------------
+// text-body-font command — CLI integration (parse → emit → dry-run JSON)
+// Track 6: Pattern A only; Pattern B refused via registry-absence.
+// ------------------------------------------------------------------
+test("--help advertises the text-body-font command (Pattern A only)", async () => {
+    const io = capture();
+    const code = await run(["--help"], io);
+    assert.equal(code, EXIT.OK);
+    const help = io.stdout.join("\n");
+    assert.match(help, /text-body-font/);
+    assert.match(help, /Pattern A/);
+});
+test("text-body-font dry-run (Pattern A) emits canonical JSON, exit 0", async () => {
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--pattern",
+        "google",
+        "--font-family",
+        "Inter",
+        "--font-weight",
+        "400",
+        "--font-color",
+        "gcid-body-color",
+        "--font-size",
+        "16px",
+    ], io);
+    assert.equal(code, EXIT.OK);
+    const parsed = JSON.parse(io.stdout.join("\n"));
+    assert.equal(parsed.type, "group");
+    assert.equal(parsed.dry_run, true);
+    assert.equal(parsed.module_name, "divi/text");
+    assert.equal(parsed.group_name, "divi/font-body");
+    assert.equal(parsed.group_id, "designText");
+    const value = parsed.attrs.content.decoration.bodyFont.body.font.desktop.value;
+    assert.equal(value.family, "Inter");
+    assert.equal(value.weight, "400");
+    assert.equal(value.size, "16px");
+    assert.equal(value.color, '$variable({"type":"color","value":{"name":"gcid-body-color","settings":{}}})$');
+});
+test("text-body-font dry-run omits weight/size/lineHeight keys when not specified", async () => {
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--pattern",
+        "google",
+        "--font-family",
+        "Inter",
+    ], io);
+    assert.equal(code, EXIT.OK);
+    const parsed = JSON.parse(io.stdout.join("\n"));
+    const value = parsed.attrs.content.decoration.bodyFont.body.font.desktop.value;
+    assert.deepEqual(Object.keys(value), ["family"]);
+});
+test("text-body-font without --pattern exits 1 (invalid input)", async () => {
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--font-family",
+        "Inter",
+        "--font-weight",
+        "400",
+    ], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /--pattern/);
+    assert.match(io.stderr.join("\n"), /google\|local/);
+});
+test("text-body-font without --name exits 1", async () => {
+    const io = capture();
+    const code = await run(["text-body-font", "--pattern", "google", "--font-family", "Inter"], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /requires --name/);
+});
+test("text-body-font --pattern local is refused (registry-absence), exit 2", async () => {
+    // Track 6 contract: Pattern B has NO registry entry for `divi/font-body`.
+    // The CLI must exit non-zero. The registry-absence throw is NOT an
+    // EvidenceGateError (no resolution constructed) — it surfaces as a
+    // plain Error and the CLI's fallback branch returns INVALID_INPUT (1).
+    // What matters here is: (a) non-zero exit; (b) the error message names
+    // both family and variant so the operator can file the gap.
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--pattern",
+        "local",
+        "--font-family",
+        "Inter",
+        "--font-color",
+        "#666666",
+    ], io);
+    assert.notEqual(code, EXIT.OK, "refusal MUST exit non-zero");
+    const err = io.stderr.join("\n");
+    assert.match(err, /absent from verified-attrs\.json/);
+    assert.match(err, /divi\/font-body/);
+    assert.match(err, /local_hosted_pattern_b/);
+});
+test("text-body-font --pattern local --font-weight is ALSO refused (compound input)", async () => {
+    // Compound-input parity: adding --font-weight (or any other field) does
+    // NOT change the refusal — the gate fires on the missing variant entry
+    // regardless of which other fields are set.
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--pattern",
+        "local",
+        "--font-family",
+        "Inter",
+        "--font-weight",
+        "700",
+    ], io);
+    assert.notEqual(code, EXIT.OK);
+    const err = io.stderr.join("\n");
+    assert.match(err, /absent from verified-attrs\.json/);
+    assert.match(err, /local_hosted_pattern_b/);
+});
+test("text-body-font --pattern with an invalid value exits 1", async () => {
+    const io = capture();
+    const code = await run([
+        "text-body-font",
+        "--name",
+        "Body",
+        "--pattern",
+        "auto",
+        "--font-family",
+        "Inter",
+    ], io);
+    assert.equal(code, EXIT.INVALID_INPUT);
+    assert.match(io.stderr.join("\n"), /--pattern must be/);
+});
+test("text-body-font dry-run requires no credentials and no network", async () => {
+    const saved = {
+        WP_URL: process.env.WP_URL,
+        WP_USER: process.env.WP_USER,
+        WP_APP_PASSWORD: process.env.WP_APP_PASSWORD,
+    };
+    delete process.env.WP_URL;
+    delete process.env.WP_USER;
+    delete process.env.WP_APP_PASSWORD;
+    try {
+        const io = capture();
+        const code = await run([
+            "text-body-font",
+            "--name",
+            "Body",
+            "--pattern",
+            "google",
+            "--font-family",
+            "Inter",
+        ], io);
+        assert.equal(code, EXIT.OK);
+        assert.equal(io.stderr.length, 0, "no error output on credential-free dry-run");
+    }
+    finally {
+        if (saved.WP_URL !== undefined)
+            process.env.WP_URL = saved.WP_URL;
+        if (saved.WP_USER !== undefined)
+            process.env.WP_USER = saved.WP_USER;
+        if (saved.WP_APP_PASSWORD !== undefined)
+            process.env.WP_APP_PASSWORD = saved.WP_APP_PASSWORD;
+    }
+});
+test("text-body-font --apply without credentials exits 1 with a credentials hint", async () => {
+    const saved = {
+        WP_URL: process.env.WP_URL,
+        WP_USER: process.env.WP_USER,
+        WP_APP_PASSWORD: process.env.WP_APP_PASSWORD,
+    };
+    delete process.env.WP_URL;
+    delete process.env.WP_USER;
+    delete process.env.WP_APP_PASSWORD;
+    try {
+        const io = capture();
+        const code = await run([
+            "text-body-font",
+            "--name",
+            "Body",
+            "--pattern",
+            "google",
+            "--font-family",
+            "Inter",
+            "--apply",
+        ], io);
+        assert.equal(code, EXIT.INVALID_INPUT);
+        assert.match(io.stderr.join("\n"), /requires WordPress credentials/);
+    }
+    finally {
+        if (saved.WP_URL !== undefined)
+            process.env.WP_URL = saved.WP_URL;
+        if (saved.WP_USER !== undefined)
+            process.env.WP_USER = saved.WP_USER;
+        if (saved.WP_APP_PASSWORD !== undefined)
+            process.env.WP_APP_PASSWORD = saved.WP_APP_PASSWORD;
+    }
+});
 test("dry-run output includes the bypass corner when requested", async () => {
     const io = capture();
     const code = await run(["button", "--name", "P", "--bg-color", "#111", "--bypass-hover-padding-gate"], io);

package/dist/preset-cli/__tests__/heading-font-emitter.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `divi/font` heading emitter shape + gating coverage:
+ *  - fixture-based shape assertion against round-1a (Pattern A) and
+ *    round-1b (Pattern B) canonical captures;
+ *  - Pattern B no-weight discriminator: omitted `weight` produces no key;
+ *  - Pattern B + explicit weight refused as unverified/out-of-scope;
+ *  - variant-aware registry gating: missing applicability or under-
+ *    verified evidence on the chosen variant throws with attr / pattern /
+ *    effective-level / source in the message; Pattern A evidence does NOT
+ *    vouch for Pattern B and vice versa.
+ */
+export {};