npm - @rubytech/create-maxy-code - Versions diffs - 0.1.118 → 0.1.120 - Mend

@rubytech/create-maxy-code 0.1.118 → 0.1.120

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

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

@@ -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 ADDED Viewed

@@ -0,0 +1 @@

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

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

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

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

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"schema-mapping.test.js","sourceRoot":"","sources":["../../src/__tests__/schema-mapping.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACjE,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACzE,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE;SAC3D,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE;gBACV,IAAI,EAAE,eAAe;gBACrB,aAAa,EAAE,WAAW;gBAC1B,eAAe,EAAE,UAAU;gBAC3B,UAAU,EAAE,SAAS;aACtB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAC1B,OAAO,EAAE,eAAe;YACxB,aAAa,EAAE,WAAW;YAC1B,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE;gBACV,SAAS,EAAE,MAAM;gBACjB,UAAU,EAAE,SAAS;gBACrB,KAAK,EAAE,eAAe;aACvB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE;SACzE,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACzB,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,GAAG;YACV,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,EAAE;SACrE,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE;gBACV,IAAI,EAAE,YAAY;gBAClB,SAAS,EAAE;oBACT,EAAE,IAAI,EAAE,wBAAwB,EAAE,cAAc,EAAE,gBAAgB,EAAE;oBACpE,EAAE,IAAI,EAAE,yBAAyB,EAAE,cAAc,EAAE,KAAK,EAAE;iBAC3D;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,GAAG,CAAC,UAAuB,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE;SACpE,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,EAAE,CACV,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAClE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE;SAC1D,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC;YACtB,KAAK,EAAE,cAAc;YACrB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC7B,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/payload/platform/plugins/aeo/mcp/dist/index.js ADDED Viewed

@@ -0,0 +1,171 @@
+import { initStderrTee } from "../../../../lib/mcp-stderr-tee/dist/index.js";
+initStderrTee("aeo");
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { eagerTool } from "../../../../lib/mcp-eager/dist/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { emitJsonLd } from "./tools/aeo-emit-jsonld.js";
+import { writeLlmsTxt } from "./tools/aeo-write-llms-txt.js";
+import { auditPage } from "./tools/aeo-audit-page.js";
+import { closeDriver } from "./lib/neo4j.js";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const server = new McpServer({
+    name: "maxy-aeo",
+    version: "0.1.0",
+});
+// Plugin-system boot tolerance — see Task 202. Module-init must never
+// throw; plugin-system spawn enumerates tools/list before ACCOUNT_ID
+// is set. Per-call refusal preserves account isolation.
+const accountId = process.env.ACCOUNT_ID ?? null;
+process.stderr.write(`[aeo] boot accountId=${accountId ?? "null"}\n`);
+function refuseNoAccount(toolName) {
+    process.stderr.write(`[aeo] tool=${toolName} refuse reason=no-account-context\n`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${toolName} cannot execute: this MCP instance was launched without ACCOUNT_ID (plugin-system metadata-only mode). Per-account AEO operations require ACCOUNT_ID at spawn.`,
+            },
+        ],
+        isError: true,
+    };
+}
+const agentSlug = process.env.AGENT_SLUG || undefined;
+const sessionId = process.env.SESSION_ID || undefined;
+// ---------------------------------------------------------------------------
+// aeo-emit-jsonld
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-emit-jsonld", "Emit a schema.org JSON-LD block for a typed graph entity. Pass entityId for a Neo4j-sourced render, or label + properties for an inline render. Returns the parsed JSON-LD object and a ready-to-inline <script> block string.", {
+    entityId: z
+        .string()
+        .optional()
+        .describe("Neo4j elementId of a typed node (Organization, Person, Service, …)"),
+    label: z
+        .string()
+        .optional()
+        .describe("Source label when rendering inline (no entityId)"),
+    properties: z
+        .record(z.unknown())
+        .optional()
+        .describe("Property bag for inline render"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-emit-jsonld");
+    try {
+        const result = await emitJsonLd({ accountId, ...args });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-emit-jsonld] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// aeo-write-llms-txt
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-write-llms-txt", "Generate /llms.txt and /llms-full.txt for the account's published KnowledgeDocument pages. Index lists every page with title, url, summary. Full file concatenates each page's body, demoting any in-body H1s to H2 to keep one heading hierarchy.", {
+    siteName: z.string().describe("Display name of the site (top H1 of llms.txt)"),
+    siteDescription: z
+        .string()
+        .optional()
+        .describe("One-line site description (emitted as a blockquote)"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-write-llms-txt");
+    try {
+        const result = await writeLlmsTxt({ accountId, ...args });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        pageCount: result.pageCount,
+                        skippedNoUrl: result.skippedNoUrl,
+                        sizeBytes: result.sizeBytes,
+                        llmsTxt: result.llmsTxt,
+                        llmsFullTxt: result.llmsFullTxt,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-llms-txt] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// aeo-audit-page
+// ---------------------------------------------------------------------------
+eagerTool(server, "aeo-audit-page", "Run the eight-heuristic AEO audit against a URL or inline HTML. Returns a 0–100 score, per-heuristic pass/warn/fail, and one rewrite suggestion per fail. Pass persist=true with targetKnowledgeDocumentId to record an :AEOAudit node linked from the document.", {
+    url: z.string().url().optional().describe("Page URL to fetch and audit"),
+    html: z.string().optional().describe("Raw HTML to audit (alternative to url)"),
+    persist: z
+        .boolean()
+        .optional()
+        .describe("If true, write an :AEOAudit node and HAS_AEO_AUDIT edge"),
+    targetKnowledgeDocumentId: z
+        .string()
+        .optional()
+        .describe("Neo4j elementId of the KnowledgeDocument to link the audit to"),
+}, async (args) => {
+    if (!accountId)
+        return refuseNoAccount("aeo-audit-page");
+    try {
+        const result = await auditPage({
+            accountId,
+            agentSlug,
+            sessionId,
+            ...args,
+        });
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[aeo-audit] error: ${message}\n`);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ---------------------------------------------------------------------------
+// Boot
+// ---------------------------------------------------------------------------
+async function shutdown() {
+    try {
+        await closeDriver();
+    }
+    catch {
+        // already-closed driver during shutdown is benign
+    }
+}
+process.on("SIGTERM", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+process.on("SIGINT", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("[aeo] ready\n");
+//# sourceMappingURL=index.js.map

package/payload/platform/plugins/aeo/mcp/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+/**
+ * Page-level AEO (Answer Engine Optimisation) heuristics. Eight checks
+ * run against raw HTML; each returns a status and, when the check fails,
+ * one concrete rewrite suggestion the operator can apply.
+ *
+ * The HTML parser is a deliberate single-pass regex scanner: AEO audits
+ * run on pages the platform itself renders, so we know they are
+ * server-side-generated, well-formed enough for regex inspection, and
+ * not gated on script-injected content. Bringing in a full DOM parser
+ * (jsdom, cheerio) would dwarf the rest of the plugin and pull in
+ * Node-version-coupled native deps. If we later need to audit
+ * third-party arbitrary HTML, swap the parser then.
+ */
+export type HeuristicStatus = "pass" | "warn" | "fail";
+export interface HeuristicResult {
+    name: HeuristicName;
+    status: HeuristicStatus;
+    detail: string;
+    suggestion?: string;
+}
+export type HeuristicName = "h1-present" | "jsonld-present" | "structured-answer" | "faq-section" | "meta-description" | "canonical-url" | "og-tags" | "heading-hierarchy";
+export interface AuditResult {
+    score: number;
+    heuristics: HeuristicResult[];
+}
+export declare function auditHtml(html: string): AuditResult;
+//# sourceMappingURL=audit-heuristics.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/lib/audit-heuristics.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"audit-heuristics.d.ts","sourceRoot":"","sources":["../../src/lib/audit-heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,gBAAgB,GAChB,mBAAmB,GACnB,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,SAAS,GACT,mBAAmB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAoRD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAOnD"}