@rubytech/create-realagent-code 0.1.116 → 0.1.118

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent-code",
-  "version": "0.1.116",
+  "version": "0.1.118",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent-code": "./dist/index.js"

package/payload/platform/neo4j/schema.cypher

@@ -1100,3 +1100,107 @@ FOR (h:CloudflareHostname) REQUIRE (h.accountId, h.hostnameValue) IS UNIQUE;
 
 CREATE INDEX cloudflare_hostname_account IF NOT EXISTS
 FOR (h:CloudflareHostname) ON (h.accountId);
+
+// ----------------------------------------------------------
+// Estate-agent ontology (Task 358) — Listing-centric model
+// documented at platform/plugins/memory/references/schema-estate-agent.md.
+//
+// These declarations exist primarily so the memory-write validator's
+// parseLabelsFromSchemaCypher() registers each label on a fresh deploy
+// where no node of the label has yet landed — without them, the first
+// :Listing write from the listing-curator agent is rejected as "unknown
+// label" against an empty db.labels() set.
+//
+// Idempotency contracts mirror schema-estate-agent.md:
+//   :Listing / :Viewing / :Offer — (accountId, sourceSystem, sourceId)
+//   :Property                    — (accountId, slug)
+//   :ImageObject                 — (accountId, listingSlug, url) for the
+//                                  estate-agent variant, (accountId, name,
+//                                  contentUrl) for the brand-asset variant.
+//                                  Because the two writers use different
+//                                  natural keys, only an accountId index is
+//                                  declared at the schema level — uniqueness
+//                                  is enforced at write time by the curator
+//                                  / brand-asset writer's MERGE clause.
+// ----------------------------------------------------------
+
+CREATE CONSTRAINT listing_account_source_unique IF NOT EXISTS
+FOR (l:Listing) REQUIRE (l.accountId, l.sourceSystem, l.sourceId) IS UNIQUE;
+
+CREATE INDEX listing_account IF NOT EXISTS
+FOR (l:Listing) ON (l.accountId);
+
+CREATE INDEX listing_status IF NOT EXISTS
+FOR (l:Listing) ON (l.status);
+
+CREATE INDEX listing_type IF NOT EXISTS
+FOR (l:Listing) ON (l.listingType);
+
+CREATE VECTOR INDEX listing_embedding IF NOT EXISTS
+FOR (l:Listing) ON (l.embedding)
+OPTIONS {
+  indexConfig: {
+    `vector.dimensions`: 768,
+    `vector.similarity_function`: 'cosine'
+  }
+};
+
+CREATE CONSTRAINT property_account_slug_unique IF NOT EXISTS
+FOR (p:Property) REQUIRE (p.accountId, p.slug) IS UNIQUE;
+
+CREATE INDEX property_account IF NOT EXISTS
+FOR (p:Property) ON (p.accountId);
+
+CREATE CONSTRAINT viewing_account_source_unique IF NOT EXISTS
+FOR (v:Viewing) REQUIRE (v.accountId, v.sourceSystem, v.sourceId) IS UNIQUE;
+
+CREATE INDEX viewing_account IF NOT EXISTS
+FOR (v:Viewing) ON (v.accountId);
+
+CREATE CONSTRAINT offer_account_source_unique IF NOT EXISTS
+FOR (o:Offer) REQUIRE (o.accountId, o.sourceSystem, o.sourceId) IS UNIQUE;
+
+CREATE INDEX offer_account IF NOT EXISTS
+FOR (o:Offer) ON (o.accountId);
+
+CREATE INDEX image_object_account IF NOT EXISTS
+FOR (i:ImageObject) ON (i.accountId);
+
+// :PostalAddress (schema:PostalAddress) — shared address nodes documented in
+// schema-base.md. Address rows are deliberately accountId-free (one address
+// can be shared across customers / orders / listings); writers MERGE on the
+// formatted address triple. Declared here so a fresh deploy registers the
+// label before the first :PostalAddress write lands.
+CREATE INDEX postal_address_postcode IF NOT EXISTS
+FOR (a:PostalAddress) ON (a.postalCode);
+
+// ----------------------------------------------------------
+// AEOAudit — Answer Engine Optimisation audit history (Task 354).
+// Written by the aeo plugin's aeo-audit-page tool when invoked
+// with persist=true. Append-only audit trail; each invocation
+// produces a new node. Linked via
+// (KnowledgeDocument)-[:HAS_AEO_AUDIT]->(AEOAudit) when the audit
+// targets a stored document, otherwise standalone keyed on
+// (accountId, target, runAt).
+//
+// Properties: accountId, auditId (uuid), target (url or
+// '(inline html)'), score (0-100), heuristicsJson (serialized
+// per-heuristic result), runAt, createdByAgent, createdBySession,
+// createdAt.
+//
+// Monitor-related labels (:AEOPrompt, :AEOCheck, :AEOCitation) are
+// intentionally NOT declared in v1 — the multi-engine monitor is
+// filed as a follow-up task and the schema will land with it.
+// ----------------------------------------------------------
+
+CREATE CONSTRAINT aeo_audit_id_unique IF NOT EXISTS
+FOR (a:AEOAudit) REQUIRE a.auditId IS UNIQUE;
+
+CREATE INDEX aeo_audit_account IF NOT EXISTS
+FOR (a:AEOAudit) ON (a.accountId);
+
+CREATE INDEX aeo_audit_target IF NOT EXISTS
+FOR (a:AEOAudit) ON (a.target);
+
+CREATE INDEX aeo_audit_run_at IF NOT EXISTS
+FOR (a:AEOAudit) ON (a.runAt);

package/payload/platform/plugins/.claude-plugin/marketplace.json

@@ -9,6 +9,11 @@
       "source": "./admin",
       "version": "0.1.0"
     },
+    {
+      "name": "aeo",
+      "source": "./aeo",
+      "version": "0.1.0"
+    },
     {
       "name": "business-assistant",
       "source": "./business-assistant",

package/payload/platform/plugins/admin/PLUGIN.md

@@ -1,5 +1,6 @@
 ---
 name: admin
+surface: platform
 description: "Platform administration plugin. Provides system-status, public-hostname (deterministic Cloudflare public-URL resolver, single call returning the operator's canonical hostname so agents never guess property names on :CloudflareHostname nodes), brand-settings, account-manage, account-update, admin-add, admin-remove, admin-list, admin-update-pin, agent-list, agent-config-read, logs-read, plugin-read, skill-load (one-call resolve+read for SKILL.md by skill name, the canonical primitive for loading a named skill; plugin-read remains the reader for references/* and PLUGIN.md), store-skill (deterministic write counterpart to plugin-read; persists operator-authored skills as plugin files under the active account), session-reset, session-resume, file-attach, wifi, action-approval tools (action-pending, action-approve, action-reject, action-edit), and session-retrospective-mark-complete (the deterministic sentinel the session-end Stop hook reads via JSONL grep to release the retrospective gate; admin calls it once per session after running the three-pass retrospective) for managing the Maxy platform."
 tools:
   - name: system-status

package/payload/platform/plugins/aeo/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "aeo",
+  "description": "Answer Engine Optimisation. Emits schema.org JSON-LD for typed graph entities, generates llms.txt + llms-full.txt for the site, and audits pages against eight AEO heuristics with one rewrite suggestion per fail. Writes :AEOAudit history nodes when audits are persisted.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  },
+  "mcpServers": {
+    "aeo": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/mcp/dist/index.js"
+      ]
+    }
+  }
+}

package/payload/platform/plugins/aeo/PLUGIN.md

@@ -0,0 +1,81 @@
+---
+name: aeo
+description: "Answer Engine Optimisation. Emits schema.org JSON-LD for typed graph entities, generates llms.txt + llms-full.txt for the site, and audits pages against eight AEO heuristics with one rewrite suggestion per fail. Writes :AEOAudit history nodes when audits are persisted."
+tools:
+  - name: aeo-emit-jsonld
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: aeo-write-llms-txt
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: aeo-audit-page
+    publicAllowlist: false
+    adminAllowlist: true
+skills:
+  - skills/structured-answer/SKILL.md
+always: false
+embed: false
+metadata: {"platform":{}}
+mcp:
+  command: node
+  args:
+    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
+    - ${PLATFORM_ROOT}/plugins/aeo/mcp/dist/index.js
+  env:
+    MCP_SPAWN_TEE_NAME: aeo
+    LOG_DIR: ${LOG_DIR}
+    PLATFORM_ROOT: ${PLATFORM_ROOT}
+    ACCOUNT_ID: ${ACCOUNT_ID}
+    SESSION_ID: ${SESSION_ID}
+    AGENT_SLUG: ${AGENT_SLUG}
+mcp-manifest: auto
+---
+
+# AEO (Answer Engine Optimisation)
+
+This plugin makes the platform's content legible to answer engines — Claude, ChatGPT, Perplexity, Google AI Overviews, Bing Copilot. Classical SEO ranks links; AEO shapes the page so the answer-engine extractor lifts the right answer.
+
+## The three surfaces
+
+1. **JSON-LD** (`aeo-emit-jsonld`). Every typed graph entity that backs a page can be projected to a `<script type="application/ld+json">` block. The mapper covers `Organization`, `LocalBusiness`, `Person`, `Service`, `Product`, `Article`, `FAQPage`, `RealEstateListing`, `Event`. Other labels fall through to `schema:Thing` and are flagged as a doc gap.
+
+2. **llms.txt** (`aeo-write-llms-txt`). The site emits `/llms.txt` (index of pages, one link per line) and `/llms-full.txt` (concatenated full text). Format follows the current draft at `https://llmstxt.org/`. Source is `KnowledgeDocument` nodes with a `url` property. Pages without a `url` are skipped and counted in the response.
+
+3. **Audit** (`aeo-audit-page`). Run the eight-heuristic scorecard against a URL or raw HTML. Each heuristic returns pass / warn / fail with one rewrite suggestion per fail. Score is `100 * (passes + 0.5 * warns) / 8`. Pass `persist: true` with a `targetKnowledgeDocumentId` to record an `:AEOAudit` node linked back to the document.
+
+## The eight heuristics
+
+| Heuristic | Pass | Warn | Fail |
+|---|---|---|---|
+| `h1-present` | one `<h1>` | more than one | none |
+| `jsonld-present` | one or more JSON-LD blocks, all parse | some parse | none, or all unparseable |
+| `structured-answer` | first `<p>` after `<h1>` is ≤280 chars | first `<p>` is over 280 chars | no `<p>` after `<h1>` |
+| `faq-section` | `FAQPage` JSON-LD on page | FAQ text but no JSON-LD | nothing FAQ-like |
+| `meta-description` | 80–160 chars | present but outside range | absent |
+| `canonical-url` | `<link rel="canonical">` present | — | absent |
+| `og-tags` | `og:title` and `og:description` both set | — | one or both missing |
+| `heading-hierarchy` | no level skips | — | h1→h3 or similar jump |
+
+`structured-answer` is the highest-impact: answer engines lift the structured-answer span verbatim. A page can fail every other heuristic and still get cited if the first paragraph cleanly answers the question.
+
+## Persistence model
+
+The plugin only writes `:AEOAudit` nodes (when `persist: true`). It does not own the entities it reads — `KnowledgeDocument`, `Organization`, `Person`, etc. belong to the memory plugin. Edges written:
+
+- `(:KnowledgeDocument)-[:HAS_AEO_AUDIT]->(:AEOAudit)`
+
+The audit nodes carry `accountId`, `target` (URL or `(inline html)`), `score`, `heuristicsJson` (full result), `runAt`, `createdByAgent`, `createdBySession`. They form an append-only audit history; aggregate trend queries (score-over-time) walk this set.
+
+## What this plugin does not do
+
+- No LLM API calls. There is no monitor in v1. The "is my brand cited when a customer asks Claude / ChatGPT / Perplexity / Gemini" question depends on multi-engine answer harvesting that runs differently under maxy-code's no-API-key architecture, and is filed as a follow-up task.
+- No automatic emission. `aeo-emit-jsonld` returns a script block; wiring it into the platform's page render path is per-renderer work, also filed as a follow-up.
+- No publish-hook regeneration of `llms.txt`. The tool runs on demand. Hooking it into the publish event is a follow-up.
+- No prose authoring. AEO audits structure; it does not rewrite content. Writer-craft owns voice.
+
+## See also
+
+- User guide: `platform/plugins/docs/references/aeo.md`
+- Structured-answer template: `platform/plugins/aeo/skills/structured-answer/SKILL.md`
+- Schema declaration: `platform/neo4j/schema.cypher` (search `AEOAudit`)
+- Schema reference: `platform/plugins/memory/schema-base.md` (search `AEOAudit`)

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-heuristics.test.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-heuristics.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/audit-heuristics.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.js

@@ -0,0 +1,121 @@
+import { describe, it, expect } from "vitest";
+import { auditHtml } from "../lib/audit-heuristics.js";
+function pick(result, name) {
+    const r = result.heuristics.find((h) => h.name === name);
+    if (!r)
+        throw new Error(`heuristic ${name} not found`);
+    return r;
+}
+const GOOD_PAGE = `<!doctype html>
+<html><head>
+  <title>How much does a boiler service cost? — Acme</title>
+  <meta name="description" content="A standard boiler service in Brighton costs £85 to £120, takes about one hour, and includes a written safety report.">
+  <link rel="canonical" href="https://acme.test/boiler-service-cost">
+  <meta property="og:title" content="How much does a boiler service cost?">
+  <meta property="og:description" content="A standard boiler service in Brighton costs £85 to £120, takes about one hour, and includes a written safety report.">
+  <script type="application/ld+json">{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Cost?","acceptedAnswer":{"@type":"Answer","text":"£85–£120."}}]}</script>
+</head><body>
+  <h1>How much does a boiler service cost?</h1>
+  <p>A standard boiler service in Brighton costs £85 to £120 and takes about one hour.</p>
+  <h2>What's included</h2>
+  <p>Safety checks, flue gas analysis, pressure adjustment, written report.</p>
+  <h2>Frequently asked questions</h2>
+  <p>Common questions are answered above.</p>
+</body></html>`;
+const BAD_PAGE = `<!doctype html>
+<html><head><title>Acme</title></head>
+<body>
+  <div>Some words.</div>
+</body></html>`;
+describe("auditHtml — golden good page", () => {
+    const result = auditHtml(GOOD_PAGE);
+    it("scores 100", () => {
+        expect(result.score).toBe(100);
+    });
+    it("passes every heuristic", () => {
+        for (const h of result.heuristics) {
+            expect(h.status, `${h.name}: ${h.detail}`).toBe("pass");
+        }
+    });
+});
+describe("auditHtml — bad page exercises every fail path", () => {
+    const result = auditHtml(BAD_PAGE);
+    it("scores 0 or near-zero", () => {
+        expect(result.score).toBeLessThanOrEqual(10);
+    });
+    it("fails h1-present", () => {
+        expect(pick(result, "h1-present").status).toBe("fail");
+    });
+    it("fails jsonld-present", () => {
+        expect(pick(result, "jsonld-present").status).toBe("fail");
+    });
+    it("fails meta-description", () => {
+        expect(pick(result, "meta-description").status).toBe("fail");
+    });
+    it("fails canonical-url", () => {
+        expect(pick(result, "canonical-url").status).toBe("fail");
+    });
+    it("fails og-tags with both missing", () => {
+        const r = pick(result, "og-tags");
+        expect(r.status).toBe("fail");
+        expect(r.detail).toContain("og:title");
+        expect(r.detail).toContain("og:description");
+    });
+    it("emits a rewrite suggestion for every failure", () => {
+        for (const h of result.heuristics) {
+            if (h.status === "fail") {
+                expect(h.suggestion, `${h.name} missing suggestion`).toBeTruthy();
+            }
+        }
+    });
+});
+describe("auditHtml — warn paths", () => {
+    it("warns when first <p> after <h1> exceeds 280 chars", () => {
+        const long = "X".repeat(300);
+        const html = `<html><head>
+      <title>t</title>
+      <meta name="description" content="${"d".repeat(120)}">
+      <link rel="canonical" href="https://a.test">
+      <meta property="og:title" content="t">
+      <meta property="og:description" content="t">
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+    </head><body>
+      <h1>Topic</h1><p>${long}</p>
+      <h2>More</h2><p>x</p>
+    </body></html>`;
+        const result = auditHtml(html);
+        expect(pick(result, "structured-answer").status).toBe("warn");
+    });
+    it("warns when meta-description length is outside 80–160", () => {
+        const html = `<html><head>
+      <title>t</title>
+      <meta name="description" content="too short">
+      <link rel="canonical" href="https://a.test">
+      <meta property="og:title" content="t">
+      <meta property="og:description" content="t">
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+    </head><body>
+      <h1>Topic</h1><p>short answer</p>
+    </body></html>`;
+        expect(pick(auditHtml(html), "meta-description").status).toBe("warn");
+    });
+    it("warns when there are multiple <h1> elements", () => {
+        const html = `<html><body><h1>A</h1><h1>B</h1><p>x</p></body></html>`;
+        expect(pick(auditHtml(html), "h1-present").status).toBe("warn");
+    });
+    it("fails heading-hierarchy on h1→h3 skip", () => {
+        const html = `<html><body><h1>A</h1><p>x</p><h3>Skipped</h3></body></html>`;
+        const r = pick(auditHtml(html), "heading-hierarchy");
+        expect(r.status).toBe("fail");
+        expect(r.detail).toContain("h1");
+        expect(r.detail).toContain("h3");
+    });
+    it("warns on unparseable JSON-LD when other blocks parse", () => {
+        const html = `<html><head>
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+      <script type="application/ld+json">not json</script>
+    </head><body><h1>T</h1><p>a</p></body></html>`;
+        expect(pick(auditHtml(html), "jsonld-present").status).toBe("warn");
+    });
+});
+//# sourceMappingURL=audit-heuristics.test.js.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-heuristics.test.js","sourceRoot":"","sources":["../../src/__tests__/audit-heuristics.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,SAAS,IAAI,CAAC,MAAoC,EAAE,IAAY;IAC9D,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,YAAY,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;eAeH,CAAC;AAEhB,MAAM,QAAQ,GAAG;;;;eAIF,CAAC;AAEhB,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAEpC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;QACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,UAAU,EAAE,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,IAAI,GACR,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,IAAI,GAAG;;0CAEyB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;;;;;;yBAMhC,IAAI;;mBAEV,CAAC;QAChB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG;;;;;;;;;mBASE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,wDAAwD,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG,8DAA8D,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACrD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG;;;kDAGiC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-mapping.test.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-mapping.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-mapping.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from "vitest";
+import { buildJsonLd, renderJsonLdScript, resolveSchemaType, MissingPropertyError, } from "../lib/schema-mapping.js";
+describe("resolveSchemaType", () => {
+    it("maps known graph labels to schema.org types", () => {
+        expect(resolveSchemaType("LocalBusiness")).toBe("LocalBusiness");
+        expect(resolveSchemaType("Organization")).toBe("Organization");
+        expect(resolveSchemaType("Person")).toBe("Person");
+        expect(resolveSchemaType("Service")).toBe("Service");
+        expect(resolveSchemaType("Product")).toBe("Product");
+        expect(resolveSchemaType("CreativeWork")).toBe("Article");
+        expect(resolveSchemaType("Article")).toBe("Article");
+        expect(resolveSchemaType("FAQPage")).toBe("FAQPage");
+        expect(resolveSchemaType("Listing")).toBe("RealEstateListing");
+        expect(resolveSchemaType("RealEstateListing")).toBe("RealEstateListing");
+        expect(resolveSchemaType("Event")).toBe("Event");
+    });
+    it("falls back to Thing for unknown labels", () => {
+        expect(resolveSchemaType("UnknownLabel")).toBe("Thing");
+    });
+});
+describe("buildJsonLd", () => {
+    it("renders an Organization with required name", () => {
+        const obj = buildJsonLd({
+            label: "Organization",
+            properties: { name: "Acme", website: "https://acme.test" },
+        });
+        expect(obj["@context"]).toBe("https://schema.org");
+        expect(obj["@type"]).toBe("Organization");
+        expect(obj.name).toBe("Acme");
+        expect(obj.url).toBe("https://acme.test");
+    });
+    it("renders a LocalBusiness with nested PostalAddress", () => {
+        const obj = buildJsonLd({
+            label: "LocalBusiness",
+            elementId: "4:abc:1",
+            properties: {
+                name: "Acme Plumbing",
+                streetAddress: "1 High St",
+                addressLocality: "Brighton",
+                postalCode: "BN1 1AA",
+            },
+        });
+        expect(obj["@id"]).toBe("4:abc:1");
+        expect(obj.address).toEqual({
+            "@type": "PostalAddress",
+            streetAddress: "1 High St",
+            addressLocality: "Brighton",
+            postalCode: "BN1 1AA",
+        });
+    });
+    it("renders a Person and synthesises name from givenName + familyName", () => {
+        const obj = buildJsonLd({
+            label: "Person",
+            properties: {
+                givenName: "Joel",
+                familyName: "Smalley",
+                email: "j@example.com",
+            },
+        });
+        expect(obj["@type"]).toBe("Person");
+        expect(obj.name).toBe("Joel Smalley");
+        expect(obj.email).toBe("j@example.com");
+    });
+    it("renders a Service with an Offer when price is set", () => {
+        const obj = buildJsonLd({
+            label: "Service",
+            properties: { name: "Boiler service", price: 120, priceCurrency: "GBP" },
+        });
+        expect(obj.offers).toEqual({
+            "@type": "Offer",
+            price: 120,
+            priceCurrency: "GBP",
+        });
+    });
+    it("renders an Article remapping title→headline and abstract→description", () => {
+        const obj = buildJsonLd({
+            label: "Article",
+            properties: { title: "How boilers work", abstract: "Short summary" },
+        });
+        expect(obj.headline).toBe("How boilers work");
+        expect(obj.description).toBe("Short summary");
+    });
+    it("renders an FAQPage with mainEntity Question/Answer pairs", () => {
+        const obj = buildJsonLd({
+            label: "FAQPage",
+            properties: {
+                name: "Boiler FAQ",
+                questions: [
+                    { name: "How long does it take?", acceptedAnswer: "About an hour." },
+                    { name: "Do you charge call-out?", acceptedAnswer: "No." },
+                ],
+            },
+        });
+        expect(Array.isArray(obj.mainEntity)).toBe(true);
+        const main = obj.mainEntity;
+        expect(main).toHaveLength(2);
+    });
+    it("renders an Event with required name + startDate", () => {
+        const obj = buildJsonLd({
+            label: "Event",
+            properties: { name: "Open day", startDate: "2026-06-01T10:00:00Z" },
+        });
+        expect(obj.startDate).toBe("2026-06-01T10:00:00Z");
+    });
+    it("throws MissingPropertyError when required property is absent", () => {
+        expect(() => buildJsonLd({ label: "Event", properties: { name: "Open day" } })).toThrow(MissingPropertyError);
+    });
+    it("renders unknown labels as schema:Thing without throwing", () => {
+        const obj = buildJsonLd({
+            label: "Mystery",
+            properties: { name: "Anonymous", description: "Unknown" },
+        });
+        expect(obj["@type"]).toBe("Thing");
+        expect(obj.name).toBe("Anonymous");
+    });
+});
+describe("renderJsonLdScript", () => {
+    it("wraps the JSON in a script block", () => {
+        const obj = buildJsonLd({
+            label: "Organization",
+            properties: { name: "Acme" },
+        });
+        const block = renderJsonLdScript(obj);
+        expect(block).toMatch(/^<script type="application\/ld\+json">/);
+        expect(block).toMatch(/<\/script>$/);
+        expect(block).toContain('"Acme"');
+    });
+});
+//# sourceMappingURL=schema-mapping.test.js.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-mapping.test.js","sourceRoot":"","sources":["../../src/__tests__/schema-mapping.test.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/aeo/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}