@rubytech/create-realagent-code 0.1.116 → 0.1.118

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

@@ -0,0 +1,254 @@
+/**
+ * Maps Neo4j node labels to schema.org types and builds JSON-LD payloads
+ * suitable for inline `<script type="application/ld+json">` blocks on
+ * rendered pages.
+ *
+ * Coverage matches Task 354 spec §1 — the seven page types that the
+ * platform's typed nodes cover natively. Labels outside this set fall
+ * through to a generic `schema:Thing` projection; callers should treat
+ * a generic result as a doc gap, not a success.
+ *
+ * The mapper is deliberately strict: every emitted JSON-LD object names
+ * `@context` and `@type` and carries `@id` when an `elementId` is
+ * available. Missing required properties for the chosen type produce a
+ * `MissingPropertyError`; callers surface this rather than emitting an
+ * invalid block.
+ */
+export class MissingPropertyError extends Error {
+    schemaType;
+    missing;
+    constructor(schemaType, missing) {
+        super(`JSON-LD ${schemaType} requires ${missing.join(", ")} but received none`);
+        this.schemaType = schemaType;
+        this.missing = missing;
+        this.name = "MissingPropertyError";
+    }
+}
+/**
+ * Label-to-schema.org-type resolution.
+ *
+ * - `LocalBusiness` keeps its own schema type (it's a schema.org subtype
+ *   of `Organization`, but is more specific and SEO-relevant when set).
+ * - `Article` covers the platform's narrative `CreativeWork` label when
+ *   it has article-shaped fields (`headline` or `title`).
+ * - `FAQPage` is recognised by the `FAQPage` label OR a `Question`
+ *   collection — the caller picks.
+ * - `RealEstateListing` is the schema.org subtype of `Product` used by
+ *   estate-agent verticals.
+ */
+const LABEL_TO_SCHEMA_TYPE = {
+    Organization: "Organization",
+    LocalBusiness: "LocalBusiness",
+    Person: "Person",
+    Service: "Service",
+    Product: "Product",
+    CreativeWork: "Article",
+    Article: "Article",
+    FAQPage: "FAQPage",
+    RealEstateListing: "RealEstateListing",
+    Listing: "RealEstateListing",
+    Event: "Event",
+};
+export function resolveSchemaType(label) {
+    return LABEL_TO_SCHEMA_TYPE[label] ?? "Thing";
+}
+function readStr(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const trimmed = v.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function readNum(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string" && v.trim().length > 0) {
+        const n = Number(v);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    return undefined;
+}
+const TYPE_SPECS = {
+    Organization: {
+        required: ["name"],
+        rename: { website: "url", phone: "telephone" },
+    },
+    LocalBusiness: {
+        required: ["name"],
+        rename: { website: "url", phone: "telephone" },
+        enrich: (props, out) => {
+            const street = readStr(props.streetAddress);
+            const locality = readStr(props.addressLocality);
+            const postalCode = readStr(props.postalCode);
+            if (street || locality || postalCode) {
+                out.address = {
+                    "@type": "PostalAddress",
+                    ...(street ? { streetAddress: street } : {}),
+                    ...(locality ? { addressLocality: locality } : {}),
+                    ...(postalCode ? { postalCode } : {}),
+                };
+            }
+        },
+    },
+    Person: {
+        required: ["givenName", "familyName"],
+        rename: { phone: "telephone" },
+        enrich: (props, out) => {
+            const given = readStr(props.givenName);
+            const family = readStr(props.familyName);
+            if (given && family)
+                out.name = `${given} ${family}`;
+        },
+    },
+    Service: {
+        required: ["name"],
+        enrich: (props, out) => {
+            const price = readNum(props.price);
+            const currency = readStr(props.priceCurrency);
+            if (price !== undefined) {
+                out.offers = {
+                    "@type": "Offer",
+                    price,
+                    ...(currency ? { priceCurrency: currency } : { priceCurrency: "GBP" }),
+                };
+            }
+        },
+    },
+    Product: {
+        required: ["name"],
+        enrich: (props, out) => {
+            const price = readNum(props.price);
+            const currency = readStr(props.priceCurrency);
+            if (price !== undefined) {
+                out.offers = {
+                    "@type": "Offer",
+                    price,
+                    ...(currency ? { priceCurrency: currency } : { priceCurrency: "GBP" }),
+                };
+            }
+        },
+    },
+    Article: {
+        required: ["title"],
+        rename: { title: "headline", abstract: "description", body: "articleBody" },
+    },
+    FAQPage: {
+        required: ["name"],
+        enrich: (props, out) => {
+            const questions = Array.isArray(props.questions)
+                ? props.questions
+                : [];
+            const mainEntity = [];
+            for (const q of questions) {
+                const name = readStr(q.name);
+                const answer = readStr(q.acceptedAnswer);
+                if (!name || !answer)
+                    continue;
+                mainEntity.push({
+                    "@type": "Question",
+                    name,
+                    acceptedAnswer: { "@type": "Answer", text: answer },
+                });
+            }
+            if (mainEntity.length > 0)
+                out.mainEntity = mainEntity;
+        },
+    },
+    RealEstateListing: {
+        required: ["name"],
+        rename: { title: "name", abstract: "description" },
+        enrich: (props, out) => {
+            const price = readNum(props.price);
+            const currency = readStr(props.priceCurrency);
+            if (price !== undefined) {
+                out.offers = {
+                    "@type": "Offer",
+                    price,
+                    ...(currency ? { priceCurrency: currency } : { priceCurrency: "GBP" }),
+                };
+            }
+            const street = readStr(props.streetAddress);
+            const locality = readStr(props.addressLocality);
+            const postalCode = readStr(props.postalCode);
+            if (street || locality || postalCode) {
+                out.address = {
+                    "@type": "PostalAddress",
+                    ...(street ? { streetAddress: street } : {}),
+                    ...(locality ? { addressLocality: locality } : {}),
+                    ...(postalCode ? { postalCode } : {}),
+                };
+            }
+        },
+    },
+    Event: {
+        required: ["name", "startDate"],
+        rename: {},
+    },
+};
+/** Plain properties always copied verbatim when present. */
+const COMMON_KEYS = [
+    "name",
+    "description",
+    "url",
+    "image",
+    "email",
+    "telephone",
+    "givenName",
+    "familyName",
+    "jobTitle",
+    "headline",
+    "articleBody",
+    "datePublished",
+    "dateModified",
+    "startDate",
+    "endDate",
+    "location",
+];
+function applyCommon(props, out, rename = {}) {
+    const renameInverse = {};
+    for (const [from, to] of Object.entries(rename))
+        renameInverse[from] = to;
+    for (const key of COMMON_KEYS) {
+        const v = props[key];
+        if (typeof v === "string" || typeof v === "number") {
+            out[key] = v;
+        }
+    }
+    for (const [from, to] of Object.entries(renameInverse)) {
+        const v = props[from];
+        if (typeof v === "string" || typeof v === "number") {
+            out[to] = v;
+        }
+    }
+}
+/**
+ * Build a JSON-LD object from a typed entity. Throws
+ * `MissingPropertyError` when the resolved schema.org type's required
+ * properties are not satisfied.
+ */
+export function buildJsonLd(input) {
+    const schemaType = resolveSchemaType(input.label);
+    const out = {
+        "@context": "https://schema.org",
+        "@type": schemaType,
+    };
+    if (input.elementId)
+        out["@id"] = input.elementId;
+    if (schemaType === "Thing") {
+        applyCommon(input.properties, out);
+        return out;
+    }
+    const spec = TYPE_SPECS[schemaType];
+    applyCommon(input.properties, out, spec.rename);
+    spec.enrich?.(input.properties, out);
+    const renamedRequired = spec.required.map((k) => spec.rename?.[k] ?? k);
+    const missing = renamedRequired.filter((k) => out[k] === undefined);
+    if (missing.length > 0) {
+        throw new MissingPropertyError(schemaType, missing);
+    }
+    return out;
+}
+/** Render a JSON-LD object as a `<script>` block string. */
+export function renderJsonLdScript(obj) {
+    return `<script type="application/ld+json">\n${JSON.stringify(obj, null, 2)}\n</script>`;
+}
+//# sourceMappingURL=schema-mapping.js.map

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

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

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-audit-page.d.ts

@@ -0,0 +1,25 @@
+import { type AuditResult } from "../lib/audit-heuristics.js";
+export interface AuditPageInput {
+    accountId: string;
+    /** Provide one of `url` or `html`. */
+    url?: string;
+    html?: string;
+    /**
+     * When true, the audit result is persisted as an `:AEOAudit` node
+     * with `HAS_AEO_AUDIT` edge from `targetKnowledgeDocumentId` (if
+     * given) or the synthetic `targetUrl` audit history.
+     */
+    persist?: boolean;
+    targetKnowledgeDocumentId?: string;
+    agentSlug?: string;
+    sessionId?: string;
+}
+export interface AuditPageResult extends AuditResult {
+    target: string;
+    audit: {
+        elementId?: string;
+        runAt: string;
+    };
+}
+export declare function auditPage(input: AuditPageInput): Promise<AuditPageResult>;
+//# sourceMappingURL=aeo-audit-page.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-audit-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-audit-page.d.ts","sourceRoot":"","sources":["../../src/tools/aeo-audit-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAeD,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,CAAC,CA2E1B"}

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-audit-page.js

@@ -0,0 +1,78 @@
+import { randomUUID } from "node:crypto";
+import { auditHtml } from "../lib/audit-heuristics.js";
+import { getSession } from "../lib/neo4j.js";
+async function fetchHtml(url) {
+    const res = await fetch(url, {
+        redirect: "follow",
+        headers: { "User-Agent": "maxy-aeo-audit/0.1" },
+    });
+    if (!res.ok) {
+        throw new Error(`aeo-audit-page: GET ${url} returned HTTP ${res.status}`);
+    }
+    return await res.text();
+}
+export async function auditPage(input) {
+    if (!input.url && !input.html) {
+        throw new Error("aeo-audit-page requires one of url or html");
+    }
+    if (input.url && input.html) {
+        throw new Error("aeo-audit-page: pass exactly one of url or html, not both");
+    }
+    const html = input.html ?? (await fetchHtml(input.url));
+    const target = input.url ?? "(inline html)";
+    const result = auditHtml(html);
+    const runAt = new Date().toISOString();
+    const fails = result.heuristics
+        .filter((h) => h.status === "fail")
+        .map((h) => h.name);
+    const warns = result.heuristics
+        .filter((h) => h.status === "warn")
+        .map((h) => h.name);
+    process.stderr.write(`[aeo-audit] target=${target} score=${result.score} fails=${fails.join(",") || "-"} warns=${warns.join(",") || "-"}\n`);
+    let elementId;
+    if (input.persist) {
+        const auditId = randomUUID();
+        const session = getSession();
+        try {
+            const r = await session.run(`CREATE (a:AEOAudit {
+           accountId: $accountId,
+           auditId: $auditId,
+           target: $target,
+           score: $score,
+           heuristicsJson: $heuristicsJson,
+           runAt: $runAt,
+           createdByAgent: $agent,
+           createdBySession: $session,
+           createdAt: $runAt
+         })
+         WITH a
+         OPTIONAL MATCH (d:KnowledgeDocument)
+           WHERE elementId(d) = $kdocId AND d.accountId = $accountId
+         FOREACH (_ IN CASE WHEN d IS NULL THEN [] ELSE [1] END |
+           MERGE (d)-[:HAS_AEO_AUDIT]->(a)
+         )
+         RETURN elementId(a) AS id`, {
+                accountId: input.accountId,
+                auditId,
+                target,
+                score: result.score,
+                heuristicsJson: JSON.stringify(result.heuristics),
+                runAt,
+                agent: input.agentSlug ?? "system",
+                session: input.sessionId ?? null,
+                kdocId: input.targetKnowledgeDocumentId ?? null,
+            });
+            elementId = r.records[0]?.get("id");
+            process.stderr.write(`[aeo-audit] persisted auditId=${auditId} elementId=${elementId ?? "-"}\n`);
+        }
+        finally {
+            await session.close();
+        }
+    }
+    return {
+        ...result,
+        target,
+        audit: { elementId, runAt },
+    };
+}
+//# sourceMappingURL=aeo-audit-page.js.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-audit-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-audit-page.js","sourceRoot":"","sources":["../../src/tools/aeo-audit-page.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-emit-jsonld.d.ts

@@ -0,0 +1,18 @@
+import { MissingPropertyError, type JsonLdObject } from "../lib/schema-mapping.js";
+export interface EmitJsonLdInput {
+    accountId: string;
+    /** Pull entity from the graph by Neo4j elementId. */
+    entityId?: string;
+    /** Or render a JSON-LD block from an inline label + property bag. */
+    label?: string;
+    properties?: Record<string, unknown>;
+}
+export interface EmitJsonLdResult {
+    jsonLd: JsonLdObject;
+    scriptBlock: string;
+    schemaType: string;
+    source: "graph" | "inline";
+}
+export declare function emitJsonLd(input: EmitJsonLdInput): Promise<EmitJsonLdResult>;
+export { MissingPropertyError };
+//# sourceMappingURL=aeo-emit-jsonld.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-emit-jsonld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-emit-jsonld.d.ts","sourceRoot":"","sources":["../../src/tools/aeo-emit-jsonld.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,oBAAoB,EACpB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAMD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA8D3B;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-emit-jsonld.js

@@ -0,0 +1,56 @@
+import { getSession } from "../lib/neo4j.js";
+import { buildJsonLd, renderJsonLdScript, MissingPropertyError, } from "../lib/schema-mapping.js";
+function isPropertyBag(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export async function emitJsonLd(input) {
+    if (!input.entityId && !input.label) {
+        throw new Error("aeo-emit-jsonld requires either entityId or label+properties");
+    }
+    if (input.entityId) {
+        const session = getSession();
+        try {
+            const r = await session.run(`MATCH (n) WHERE elementId(n) = $id AND n.accountId = $accountId
+         RETURN labels(n) AS labels, properties(n) AS props, elementId(n) AS id LIMIT 1`, { id: input.entityId, accountId: input.accountId });
+            if (r.records.length === 0) {
+                throw new Error(`aeo-emit-jsonld: no node with elementId=${input.entityId} in account=${input.accountId}`);
+            }
+            const rec = r.records[0];
+            const labels = rec.get("labels");
+            const props = rec.get("props");
+            const id = rec.get("id");
+            const primaryLabel = labels.find((l) => l !== "Resource") ?? labels[0];
+            const obj = buildJsonLd({
+                label: primaryLabel,
+                elementId: id,
+                properties: props,
+            });
+            process.stderr.write(`[aeo-emit-jsonld] entityId=${id} schemaType=${obj["@type"]} source=graph\n`);
+            return {
+                jsonLd: obj,
+                scriptBlock: renderJsonLdScript(obj),
+                schemaType: obj["@type"],
+                source: "graph",
+            };
+        }
+        finally {
+            await session.close();
+        }
+    }
+    if (!input.label || !isPropertyBag(input.properties)) {
+        throw new Error("aeo-emit-jsonld: label requires a properties object");
+    }
+    const obj = buildJsonLd({
+        label: input.label,
+        properties: input.properties,
+    });
+    process.stderr.write(`[aeo-emit-jsonld] label=${input.label} schemaType=${obj["@type"]} source=inline\n`);
+    return {
+        jsonLd: obj,
+        scriptBlock: renderJsonLdScript(obj),
+        schemaType: obj["@type"],
+        source: "inline",
+    };
+}
+export { MissingPropertyError };
+//# sourceMappingURL=aeo-emit-jsonld.js.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-emit-jsonld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-emit-jsonld.js","sourceRoot":"","sources":["../../src/tools/aeo-emit-jsonld.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-write-llms-txt.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Generates the `llms.txt` and `llms-full.txt` pair for an account's
+ * published content. Format follows the current llmstxt.org draft:
+ *
+ *   # <Site name>
+ *   > <Short description>
+ *
+ *   ## <Section name>
+ *   - [<Title>](<URL>): <Summary>
+ *
+ * `llms-full.txt` concatenates the full text of every listed page in
+ * the same order, separated by a blank line and the page's title as an
+ * H1.
+ *
+ * Source: `KnowledgeDocument` nodes for the account that have a `url`
+ * property. `summary` and `body` properties feed the index and the
+ * concatenated dump respectively. Pages without a `url` are skipped
+ * (they aren't reachable from a public site), and the count of skipped
+ * pages is returned so the operator can audit completeness.
+ */
+export interface WriteLlmsTxtInput {
+    accountId: string;
+    siteName: string;
+    siteDescription?: string;
+}
+export interface WriteLlmsTxtResult {
+    llmsTxt: string;
+    llmsFullTxt: string;
+    pageCount: number;
+    skippedNoUrl: number;
+    sizeBytes: {
+        index: number;
+        full: number;
+    };
+}
+export declare function writeLlmsTxt(input: WriteLlmsTxtInput): Promise<WriteLlmsTxtResult>;
+//# sourceMappingURL=aeo-write-llms-txt.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-write-llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-write-llms-txt.d.ts","sourceRoot":"","sources":["../../src/tools/aeo-write-llms-txt.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAqBD,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA4F7B"}

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-write-llms-txt.js

@@ -0,0 +1,94 @@
+import { getSession } from "../lib/neo4j.js";
+const HEADER_RX = /^#\s/m;
+function escapeMarkdown(text) {
+    return text.replace(/[\[\]\(\)\n\r]/g, " ").trim();
+}
+function summariseBody(body) {
+    const flat = body.replace(/\s+/g, " ").trim();
+    if (flat.length <= 200)
+        return flat;
+    return flat.slice(0, 197).trimEnd() + "…";
+}
+export async function writeLlmsTxt(input) {
+    const session = getSession();
+    let rows = [];
+    let skippedNoUrl = 0;
+    try {
+        const r = await session.run(`MATCH (d:KnowledgeDocument {accountId: $accountId})
+       RETURN d.title AS title, d.url AS url, d.summary AS summary,
+              coalesce(d.body, d.abstract, '') AS body
+       ORDER BY d.title ASC`, { accountId: input.accountId });
+        for (const rec of r.records) {
+            const title = rec.get("title") ?? "";
+            const url = rec.get("url") ?? "";
+            const summary = rec.get("summary") ?? "";
+            const body = rec.get("body") ?? "";
+            if (!url || !title) {
+                skippedNoUrl += 1;
+                continue;
+            }
+            rows.push({
+                title: escapeMarkdown(title),
+                url: url.trim(),
+                summary: escapeMarkdown(summary) || summariseBody(body) || "(no summary)",
+                body: body.trim(),
+            });
+        }
+    }
+    finally {
+        await session.close();
+    }
+    const indexLines = [];
+    indexLines.push(`# ${escapeMarkdown(input.siteName)}`);
+    indexLines.push("");
+    if (input.siteDescription) {
+        indexLines.push(`> ${escapeMarkdown(input.siteDescription)}`);
+        indexLines.push("");
+    }
+    indexLines.push("## Pages");
+    indexLines.push("");
+    for (const row of rows) {
+        indexLines.push(`- [${row.title}](${row.url}): ${row.summary}`);
+    }
+    indexLines.push("");
+    indexLines.push("<!-- generated by @maxy/aeo aeo-write-llms-txt; spec: https://llmstxt.org/ -->");
+    const llmsTxt = indexLines.join("\n");
+    const fullLines = [];
+    fullLines.push(`# ${escapeMarkdown(input.siteName)}`);
+    fullLines.push("");
+    if (input.siteDescription) {
+        fullLines.push(`> ${escapeMarkdown(input.siteDescription)}`);
+        fullLines.push("");
+    }
+    for (const row of rows) {
+        fullLines.push(`# ${row.title}`);
+        fullLines.push("");
+        fullLines.push(`Source: ${row.url}`);
+        fullLines.push("");
+        if (row.body) {
+            // Demote any in-body H1s to H2 so a single H1 hierarchy holds.
+            const safeBody = row.body.replace(HEADER_RX, "## ");
+            fullLines.push(safeBody);
+        }
+        else {
+            fullLines.push(row.summary);
+        }
+        fullLines.push("");
+        fullLines.push("---");
+        fullLines.push("");
+    }
+    const llmsFullTxt = fullLines.join("\n");
+    const sizeBytes = {
+        index: Buffer.byteLength(llmsTxt, "utf-8"),
+        full: Buffer.byteLength(llmsFullTxt, "utf-8"),
+    };
+    process.stderr.write(`[aeo-llms-txt] site=${input.siteName} pages=${rows.length} skippedNoUrl=${skippedNoUrl} indexBytes=${sizeBytes.index} fullBytes=${sizeBytes.full}\n`);
+    return {
+        llmsTxt,
+        llmsFullTxt,
+        pageCount: rows.length,
+        skippedNoUrl,
+        sizeBytes,
+    };
+}
+//# sourceMappingURL=aeo-write-llms-txt.js.map

package/payload/platform/plugins/aeo/mcp/dist/tools/aeo-write-llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo-write-llms-txt.js","sourceRoot":"","sources":["../../src/tools/aeo-write-llms-txt.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/aeo/mcp/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@maxy/aeo",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "neo4j-driver": "^5.28.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "vitest": "^4.1.2"
+  }
+}

package/payload/platform/plugins/aeo/mcp/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["src/**/__tests__/**/*.test.ts"],
+    testTimeout: 10_000,
+  },
+});