@aeptus/aexeo-emdash 0.1.2 → 0.3.0

package/dist/admin.js

@@ -0,0 +1,492 @@
+// src/admin/Facts.tsx
+import { useCallback, useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var PLUGIN_ID = "aexeo-seogeo";
+var API_BASE = "/_emdash/api";
+function Facts() {
+  const [data, setData] = useState(null);
+  const [loadError, setLoadError] = useState(null);
+  const [draft, setDraft] = useState("");
+  const [validation, setValidation] = useState(null);
+  const [busy, setBusy] = useState(null);
+  const [toast, setToast] = useState(null);
+  const loadCurrent = useCallback(async () => {
+    setLoadError(null);
+    try {
+      const res = await callRoute("data", {});
+      setData(res);
+      const stored = res.manifest;
+      if (stored !== null) {
+        setDraft(JSON.stringify(stored, null, 2));
+      }
+    } catch (err) {
+      setLoadError(err instanceof Error ? err.message : String(err));
+    }
+  }, []);
+  useEffect(() => {
+    void loadCurrent();
+  }, [loadCurrent]);
+  const onCopyPrompt = useCallback(async () => {
+    setBusy("prompt");
+    setToast(null);
+    try {
+      const res = await callRoute("prompt", {});
+      await navigator.clipboard.writeText(res.prompt);
+      setToast(
+        "Prompt copied to clipboard \u2014 paste it into Claude/GPT, answer the LLM's questions, then come back and paste the resulting JSON below."
+      );
+    } catch (err) {
+      setToast(
+        `Failed to generate prompt: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, []);
+  const onValidate = useCallback(async () => {
+    setBusy("validate");
+    setToast(null);
+    setValidation(null);
+    try {
+      const res = await callRoute("validate", {
+        manifest_json: draft
+      });
+      setValidation(res);
+    } catch (err) {
+      setToast(
+        `Validation failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, [draft]);
+  const onSave = useCallback(async () => {
+    setBusy("save");
+    setToast(null);
+    try {
+      await callRoute("save", { manifest_json: draft });
+      setToast("Manifest saved. Site truth score will reflect it on next refresh.");
+      await loadCurrent();
+    } catch (err) {
+      setToast(
+        `Save failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, [draft, loadCurrent]);
+  const validationOk = validation !== null && validation.validation.valid && validation.validation.errors.length === 0 && validation.assessment.mismatches.filter((m) => m.severity === "error").length === 0;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-6 p-4", children: [
+    /* @__PURE__ */ jsxs("header", { children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "Truth manifest" }),
+      /* @__PURE__ */ jsxs("p", { className: "mt-1 text-sm text-kumo-subtle", children: [
+        "Author a ",
+        /* @__PURE__ */ jsx("code", { children: "facts.json" }),
+        " using your LLM of choice. The plugin frames the question, validates the answer, and stores the result. Read",
+        " ",
+        /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: "https://github.com/schiste/Aexeo/blob/main/docs/facts-manifest.md",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: "text-kumo-link hover:underline",
+            children: "the authoring guide"
+          }
+        ),
+        " ",
+        "for the philosophy behind this flow."
+      ] })
+    ] }),
+    loadError !== null && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-3 text-sm text-red-700", children: [
+      "Failed to load manifest state: ",
+      loadError
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Status" }),
+      /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: data === null ? "Loading\u2026" : data.present ? "\u2713 A truth manifest is stored. Editing the JSON below replaces it on Save." : "No truth manifest stored. Generate the prompt below to author one." })
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "1. Generate authoring prompt" }),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-kumo-subtle", children: "Copies a populated prompt to your clipboard. Paste it into Claude/GPT/etc., answer the LLM's questions, and bring the resulting JSON back here." }),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: () => void onCopyPrompt(),
+          disabled: busy !== null,
+          className: "rounded bg-kumo-brand px-3 py-1.5 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50",
+          children: busy === "prompt" ? "Copying\u2026" : "Copy prompt"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "2. Paste & validate" }),
+      /* @__PURE__ */ jsx(
+        "textarea",
+        {
+          value: draft,
+          onChange: (e) => setDraft(e.target.value),
+          spellCheck: false,
+          rows: 16,
+          placeholder: '{ "version": 1, "organization": { ... }, ... }',
+          className: "w-full rounded border border-kumo-line bg-kumo-tint p-2 font-mono text-xs"
+        }
+      ),
+      /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => void onValidate(),
+            disabled: busy !== null || draft.trim().length === 0,
+            className: "rounded border border-kumo-line px-3 py-1.5 text-sm hover:bg-kumo-tint disabled:opacity-50",
+            children: busy === "validate" ? "Validating\u2026" : "Validate"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => void onSave(),
+            disabled: busy !== null || !validationOk,
+            title: validationOk ? "Save to KV" : "Run Validate first; only valid manifests can be saved.",
+            className: "rounded bg-kumo-brand px-3 py-1.5 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50",
+            children: busy === "save" ? "Saving\u2026" : "Save"
+          }
+        )
+      ] })
+    ] }),
+    toast !== null && /* @__PURE__ */ jsx("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
+    validation !== null && /* @__PURE__ */ jsx(ValidationReport, { result: validation })
+  ] });
+}
+function ValidationReport({
+  result
+}) {
+  const errMismatches = result.assessment.mismatches.filter(
+    (m) => m.severity === "error"
+  );
+  const warnMismatches = result.assessment.mismatches.filter(
+    (m) => m.severity === "warning"
+  );
+  return /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+    /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Validation result" }),
+    /* @__PURE__ */ jsxs("div", { className: "text-sm", children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        "Shape:",
+        " ",
+        /* @__PURE__ */ jsx("strong", { children: result.validation.valid ? "valid" : "invalid" }),
+        " ",
+        "\xB7 org",
+        " ",
+        result.validation.organization_present ? "present" : "missing",
+        " \xB7",
+        " ",
+        result.validation.product_count,
+        " products \xB7",
+        " ",
+        result.validation.preferred_term_count,
+        " preferred terms \xB7",
+        " ",
+        result.validation.forbidden_term_count,
+        " forbidden terms"
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        "Score: ",
+        /* @__PURE__ */ jsx("strong", { children: result.assessment.score }),
+        "/",
+        result.assessment.score_ceiling,
+        " \xB7 source =",
+        " ",
+        /* @__PURE__ */ jsx("code", { children: result.assessment.structured_truth_source }),
+        " \xB7",
+        " ",
+        result.assessment.pages_analyzed,
+        " pages,",
+        " ",
+        result.assessment.pages_with_schema,
+        " with schema.org"
+      ] })
+    ] }),
+    result.validation.errors.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Schema errors:" }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: result.validation.errors.map((e, i) => /* @__PURE__ */ jsx("li", { children: e }, i)) })
+    ] }),
+    result.validation.warnings.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-yellow-500/40 bg-yellow-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Schema warnings:" }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: result.validation.warnings.map((w, i) => /* @__PURE__ */ jsx("li", { children: w }, i)) })
+    ] }),
+    errMismatches.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Mismatches with site (errors):" }),
+      /* @__PURE__ */ jsx(MismatchList, { items: errMismatches })
+    ] }),
+    warnMismatches.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-yellow-500/40 bg-yellow-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Mismatches with site (warnings):" }),
+      /* @__PURE__ */ jsx(MismatchList, { items: warnMismatches })
+    ] }),
+    result.validation.errors.length === 0 && result.assessment.mismatches.length === 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-green-500/40 bg-green-500/10 p-2 text-sm", children: [
+      "\u2713 Manifest is valid and agrees with on-page schema.org. Click",
+      " ",
+      "Save to persist."
+    ] })
+  ] });
+}
+function MismatchList({
+  items
+}) {
+  return /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: items.map((m, i) => /* @__PURE__ */ jsxs("li", { children: [
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.route }),
+    " \xB7 ",
+    m.field,
+    ": expected",
+    " ",
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.expected }),
+    ", observed",
+    " ",
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.observed }),
+    " ",
+    /* @__PURE__ */ jsxs("span", { className: "text-xs text-kumo-subtle", children: [
+      "(",
+      m.source,
+      ")"
+    ] })
+  ] }, i)) });
+}
+async function callRoute(kind, extra) {
+  const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/facts`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-EmDash-Request": "1"
+    },
+    body: JSON.stringify({ kind, ...extra })
+  });
+  const body = await res.json();
+  if (body.error !== void 0) {
+    throw new Error(`${body.error.code}: ${body.error.message}`);
+  }
+  if (body.data === void 0) {
+    throw new Error(`Empty response (HTTP ${res.status})`);
+  }
+  return body.data;
+}
+
+// src/admin/Findings.tsx
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var PLUGIN_ID2 = "aexeo-seogeo";
+var API_BASE2 = "/_emdash/api";
+function Findings() {
+  const [state, setState] = useState2({
+    loading: true,
+    error: null,
+    payload: null
+  });
+  const [refreshing, setRefreshing] = useState2(false);
+  const [toast, setToast] = useState2(null);
+  const load = useCallback2(async () => {
+    setState((s) => ({ ...s, loading: true, error: null }));
+    try {
+      const res = await fetch(`${API_BASE2}/plugins/${PLUGIN_ID2}/data`, {
+        method: "POST",
+        headers: csrfHeaders(),
+        body: "{}"
+      });
+      const body = await res.json();
+      const payload2 = unwrap(body, res);
+      setState({ loading: false, error: null, payload: payload2 });
+    } catch (err) {
+      setState({
+        loading: false,
+        error: err instanceof Error ? err.message : String(err),
+        payload: null
+      });
+    }
+  }, []);
+  const refresh = useCallback2(async () => {
+    setRefreshing(true);
+    setToast(null);
+    try {
+      const res = await fetch(`${API_BASE2}/plugins/${PLUGIN_ID2}/refresh`, {
+        method: "POST",
+        headers: csrfHeaders(),
+        body: "{}"
+      });
+      const body = await res.json();
+      const data = unwrap(body, res);
+      setState({ loading: false, error: null, payload: data.payload });
+      if (data.summary) {
+        const { documentsScanned, routesUpdated, totalFindings, errors } = data.summary;
+        if (errors.length > 0) {
+          setToast(`Refresh completed with ${errors.length} errors: ${errors.join(" \u2022 ")}`);
+        } else {
+          setToast(
+            `Refreshed ${routesUpdated} routes (${totalFindings} findings across ${documentsScanned} documents)`
+          );
+        }
+      }
+    } catch (err) {
+      setToast(
+        `Refresh failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setRefreshing(false);
+    }
+  }, []);
+  useEffect2(() => {
+    void load();
+  }, [load]);
+  if (state.loading && state.payload === null) {
+    return /* @__PURE__ */ jsx2("div", { className: "p-4 text-sm text-kumo-subtle", children: "Loading findings\u2026" });
+  }
+  if (state.error !== null) {
+    return /* @__PURE__ */ jsxs2("div", { className: "p-4", children: [
+      /* @__PURE__ */ jsx2("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+      /* @__PURE__ */ jsxs2("p", { className: "mt-2 rounded border border-red-500/40 bg-red-500/10 p-3 text-sm text-red-700", children: [
+        "Failed to load: ",
+        state.error
+      ] }),
+      /* @__PURE__ */ jsx2(
+        "button",
+        {
+          type: "button",
+          onClick: () => void load(),
+          className: "mt-3 rounded border border-kumo-line px-3 py-1.5 text-sm hover:bg-kumo-tint",
+          children: "Retry"
+        }
+      )
+    ] });
+  }
+  const payload = state.payload;
+  if (payload === null) {
+    return /* @__PURE__ */ jsx2("div", { className: "p-4 text-sm text-kumo-subtle", children: "No data." });
+  }
+  const routesByPath = /* @__PURE__ */ new Map();
+  for (const route of payload.routes) {
+    routesByPath.set(route.route, route);
+  }
+  return /* @__PURE__ */ jsxs2("div", { className: "space-y-4 p-4", children: [
+    /* @__PURE__ */ jsxs2("header", { className: "flex items-center justify-between gap-4", children: [
+      /* @__PURE__ */ jsxs2("div", { children: [
+        /* @__PURE__ */ jsx2("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+        /* @__PURE__ */ jsx2("p", { className: "mt-1 text-sm text-kumo-subtle", children: payload.totals.findings === 0 ? /* @__PURE__ */ jsx2(Fragment, { children: "No findings yet \u2014 click Refresh to evaluate the site." }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
+          payload.totals.findings,
+          " findings across ",
+          payload.totals.routes,
+          " routes \u2014",
+          " ",
+          payload.totals.errors,
+          " errors, ",
+          payload.totals.warnings,
+          " warnings."
+        ] }) })
+      ] }),
+      /* @__PURE__ */ jsx2(
+        "button",
+        {
+          type: "button",
+          onClick: () => void refresh(),
+          disabled: refreshing,
+          className: "rounded bg-kumo-brand px-3 py-1.5 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50",
+          children: refreshing ? "Refreshing\u2026" : "Refresh"
+        }
+      )
+    ] }),
+    toast !== null && /* @__PURE__ */ jsx2("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
+    payload.sitewideFindings.length > 0 && /* @__PURE__ */ jsxs2("section", { className: "rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx2("h2", { className: "text-sm font-medium", children: "Sitewide" }),
+      /* @__PURE__ */ jsx2("ul", { className: "mt-2 space-y-1 text-sm", children: payload.sitewideFindings.map((finding, i) => /* @__PURE__ */ jsxs2("li", { className: "flex items-start gap-2", children: [
+        /* @__PURE__ */ jsx2(SeverityBadge, { severity: finding.severity }),
+        /* @__PURE__ */ jsx2("code", { className: "font-mono text-xs", children: finding.rule_id }),
+        /* @__PURE__ */ jsx2("span", { className: "flex-1", children: finding.message })
+      ] }, i)) })
+    ] }),
+    payload.findings.length === 0 ? /* @__PURE__ */ jsx2("p", { className: "text-sm text-kumo-subtle", children: payload.totals.documentsIndexed === 0 ? "No documents indexed \u2014 click Refresh to do an initial sweep." : "All indexed documents are clean." }) : /* @__PURE__ */ jsx2("div", { className: "overflow-x-auto rounded border border-kumo-line", children: /* @__PURE__ */ jsxs2("table", { className: "w-full text-left text-sm", children: [
+      /* @__PURE__ */ jsx2("thead", { className: "bg-kumo-tint", children: /* @__PURE__ */ jsxs2("tr", { children: [
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Route" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Rule" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Severity" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Message" })
+      ] }) }),
+      /* @__PURE__ */ jsx2("tbody", { children: payload.findings.map((finding, i) => {
+        const routeInfo = routesByPath.get(finding.route);
+        return /* @__PURE__ */ jsxs2("tr", { className: "border-t border-kumo-line", children: [
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2(RouteLinks, { finding, info: routeInfo }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2("code", { className: "rounded bg-kumo-tint px-1.5 py-0.5 font-mono text-xs", children: finding.rule_id }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2(SeverityBadge, { severity: finding.severity }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: finding.message })
+        ] }, i);
+      }) })
+    ] }) })
+  ] });
+}
+function RouteLinks({
+  finding,
+  info
+}) {
+  if (info === void 0) {
+    return /* @__PURE__ */ jsx2("span", { className: "font-mono text-xs", children: finding.route });
+  }
+  return /* @__PURE__ */ jsxs2("span", { className: "space-x-2", children: [
+    info.editUrl !== "" ? /* @__PURE__ */ jsx2(
+      "a",
+      {
+        href: info.editUrl,
+        className: "font-mono text-xs text-kumo-link hover:underline",
+        children: finding.route
+      }
+    ) : /* @__PURE__ */ jsx2("span", { className: "font-mono text-xs", children: finding.route }),
+    info.publishedUrl !== "" && /* @__PURE__ */ jsx2(
+      "a",
+      {
+        href: info.publishedUrl,
+        target: "_blank",
+        rel: "noopener noreferrer",
+        className: "text-xs text-kumo-link hover:underline",
+        children: "live \u2197"
+      }
+    ),
+    info.status !== "" && info.status !== "published" && /* @__PURE__ */ jsx2("span", { className: "text-xs text-kumo-subtle", children: info.status })
+  ] });
+}
+function SeverityBadge({ severity }) {
+  const classes = severity === "error" ? "bg-red-500/10 text-red-700 border-red-500/40" : severity === "warning" ? "bg-yellow-500/10 text-yellow-800 border-yellow-500/40" : "bg-kumo-tint text-kumo-subtle border-kumo-line";
+  return /* @__PURE__ */ jsx2(
+    "span",
+    {
+      className: `inline-block rounded border px-1.5 py-0.5 text-xs font-medium ${classes}`,
+      children: severity
+    }
+  );
+}
+function csrfHeaders() {
+  return {
+    "Content-Type": "application/json",
+    // emdash's apiFetch wrapper sets this on every mutation;
+    // mirroring it here so the plugin's REST endpoints get past the
+    // server's CSRF check the same way emdash's own admin does.
+    "X-EmDash-Request": "1"
+  };
+}
+function unwrap(body, res) {
+  if (body.error !== void 0) {
+    throw new Error(`${body.error.code}: ${body.error.message}`);
+  }
+  if (body.data === void 0) {
+    throw new Error(`Empty response (HTTP ${res.status})`);
+  }
+  return body.data;
+}
+
+// src/admin.tsx
+var pages = {
+  "/findings": Findings,
+  // /facts is the truth-manifest authoring page. Block Kit can't render
+  // a textarea or copy-to-clipboard button, so this path goes through
+  // the React adminEntry. Same mechanism as /findings.
+  "/facts": Facts
+};
+export {
+  pages
+};

package/dist/configured.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AA6EA,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAmD3E;AAID,eAAe,YAAY,CAAC"}
+{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AAiFA,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAkF3E;AAID,eAAe,YAAY,CAAC"}