@aeptus/aexeo-emdash 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -6,6 +6,91 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-04-28
+
+Adds the long-asked clickable routes on the findings page. Block
+Kit can't render external links in any element type, so /findings
+now ships as a React component registered via the plugin's
+`adminEntry`. /document and the dashboard widget continue to use
+Block Kit (no link needs there).
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Added
+
+- **Clickable routes on /findings.** Each row's route links to the
+  emdash edit URL for that document
+  (`/_emdash/admin/content/<collection>/<id>`). Published documents
+  also get a "live ↗" link to the public URL
+  (`<emdash:site_url><route>`). Drafts surface their status
+  (`draft`, `scheduled`, etc.) inline so editorial state is visible
+  at a glance.
+- **`adminEntry` field** on the configured-mode plugin descriptor.
+  Points at `@aeptus/aexeo-emdash/admin`, which exports `pages`
+  registering the `<Findings/>` React component for `/findings`.
+  emdash's `usePluginPage` hook picks this up and renders the
+  React component in place of the Block Kit fallback.
+- **Two new HTTP routes** the React component consumes:
+  - `POST /_emdash/api/plugins/aexeo-seogeo/data` — read current
+    findings + per-route metadata + computed URLs (no
+    re-evaluation).
+  - `POST /_emdash/api/plugins/aexeo-seogeo/refresh` — sweep the
+    configured collections, write findings to KV, return the same
+    payload as `/data` plus a refresh summary.
+  Both routes return JSON in the shape exported as `FindingsPayload`
+  from `dist/data-route.d.ts`. The shape is the wire contract
+  between plugin and admin component and is intentionally
+  additive — fields will be appended in future versions, never
+  renamed or removed.
+- `react` declared as an optional peer dependency
+  (`^18.0.0 || ^19.0.0`). Optional because plugins that don't use
+  the React findings page (e.g. ones that override `adminEntry`)
+  don't need it; emdash hosts that DO render adminEntry components
+  always have React installed already.
+
+### Changed
+
+- `documentKey(route)` KV entries now store
+  `{ document, meta: { id, collection, status, slug, title } }`
+  instead of the bare `EmdashDocument`. The new metadata is what
+  the React component reads to construct edit / public URLs without
+  an extra DB round-trip per row. Pre-0.2.0 entries are
+  backwards-compatible — `readAllStoredDocuments` synthesizes a
+  minimal meta blob for legacy entries so a single corrupted-shape
+  row doesn't break the page.
+
+## [0.1.2] - 2026-04-28
+
+Functional patch. Three bugs flagged by the aeptus web team after
+testing 0.1.1 against emdash 0.8.0; same `wasm/` as `0.1.0` (no
+rule-engine change).
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Fixed
+
+- **Duplicate "SEO findings" sidebar entry.** The descriptor and
+  the runtime admin both declared `/` AND `/findings` as adminPages
+  with the same label, so emdash rendered two duplicate links.
+  Drop the `/` entry — root-URL navigation
+  (`/admin/plugins/<id>/`) still works because the dispatcher in
+  `src/configured.ts` aliases the empty page name to the findings
+  page.
+
+### Added
+
+- **`seogeoPlugin({ collections })` option** for configured mode.
+  Lets sites with non-default collection slugs override which
+  collections the Refresh button sweeps. Defaults to
+  `["posts", "pages"]` when omitted (the slugs from
+  `@emdash-cms/template-blog-cloudflare`). Pointing at a missing
+  slug is non-fatal — the bridge returns empty and the sweep
+  records the missing collection in the Refresh summary's `errors`.
+- The Refresh sweep now threads the resolved collection list
+  through `handleAdminRoute` → `handleRefresh` →
+  `evaluateAndPersistAll` so the runtime honors what the descriptor
+  passed.
+
 ## [0.1.1] - 2026-04-28
 
 Documentation-only patch. No runtime changes — same `dist/` and
@@ -68,6 +153,8 @@ First public release.
   `astro.config.mjs` for the WASM import to resolve to a
   precompiled `WebAssembly.Module`. Not optional.
 
-[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.1.1...HEAD
+[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.2.0...HEAD
+[0.2.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.1.2...aexeo-emdash-v0.2.0
+[0.1.2]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.1.1...aexeo-emdash-v0.1.2
 [0.1.1]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.1.0...aexeo-emdash-v0.1.1
 [0.1.0]: https://github.com/schiste/Aexeo/releases/tag/aexeo-emdash-v0.1.0

package/dist/adapter.d.ts

@@ -12,5 +12,17 @@ export interface EmdashContentItem {
         canonical?: string | null;
     };
 }
+export interface EmdashContentMeta {
+    id: string;
+    collection: string;
+    slug: string | null;
+    status: string;
+    title: string;
+}
+export interface AdaptedContent {
+    document: EmdashDocument;
+    meta: EmdashContentMeta;
+}
 export declare function contentItemToEmdashDocument(content: EmdashContentItem): EmdashDocument;
+export declare function adaptContentItem(content: EmdashContentItem): AdaptedContent;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAmBpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAyBhB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAmBpE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAOD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IAIf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAEhB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAkC3E"}

package/dist/admin/Findings.d.ts

@@ -0,0 +1,3 @@
+import * as React from "react";
+export declare function Findings(): React.JSX.Element;
+//# sourceMappingURL=Findings.d.ts.map

package/dist/admin/Findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Findings.d.ts","sourceRoot":"","sources":["../../src/admin/Findings.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,wBAAgB,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CA2L5C"}

package/dist/admin.d.ts

@@ -0,0 +1,5 @@
+import { Findings } from "./admin/Findings.js";
+export declare const pages: {
+    "/findings": typeof Findings;
+};
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,eAAO,MAAM,KAAK;;CAEjB,CAAC"}

package/dist/admin.js

@@ -0,0 +1,214 @@
+// src/admin/Findings.tsx
+import { useCallback, useEffect, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var PLUGIN_ID = "aexeo-seogeo";
+var API_BASE = "/_emdash/api";
+function Findings() {
+  const [state, setState] = useState({
+    loading: true,
+    error: null,
+    payload: null
+  });
+  const [refreshing, setRefreshing] = useState(false);
+  const [toast, setToast] = useState(null);
+  const load = useCallback(async () => {
+    setState((s) => ({ ...s, loading: true, error: null }));
+    try {
+      const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/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 = useCallback(async () => {
+    setRefreshing(true);
+    setToast(null);
+    try {
+      const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/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);
+    }
+  }, []);
+  useEffect(() => {
+    void load();
+  }, [load]);
+  if (state.loading && state.payload === null) {
+    return /* @__PURE__ */ jsx("div", { className: "p-4 text-sm text-kumo-subtle", children: "Loading findings\u2026" });
+  }
+  if (state.error !== null) {
+    return /* @__PURE__ */ jsxs("div", { className: "p-4", children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+      /* @__PURE__ */ jsxs("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__ */ jsx(
+        "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__ */ jsx("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__ */ jsxs("div", { className: "space-y-4 p-4", children: [
+    /* @__PURE__ */ jsxs("header", { className: "flex items-center justify-between gap-4", children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+        /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-kumo-subtle", children: payload.totals.findings === 0 ? /* @__PURE__ */ jsx(Fragment, { children: "No findings yet \u2014 click Refresh to evaluate the site." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+          payload.totals.findings,
+          " findings across ",
+          payload.totals.routes,
+          " routes \u2014",
+          " ",
+          payload.totals.errors,
+          " errors, ",
+          payload.totals.warnings,
+          " warnings."
+        ] }) })
+      ] }),
+      /* @__PURE__ */ jsx(
+        "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__ */ jsx("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
+    payload.sitewideFindings.length > 0 && /* @__PURE__ */ jsxs("section", { className: "rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Sitewide" }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-2 space-y-1 text-sm", children: payload.sitewideFindings.map((finding, i) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2", children: [
+        /* @__PURE__ */ jsx(SeverityBadge, { severity: finding.severity }),
+        /* @__PURE__ */ jsx("code", { className: "font-mono text-xs", children: finding.rule_id }),
+        /* @__PURE__ */ jsx("span", { className: "flex-1", children: finding.message })
+      ] }, i)) })
+    ] }),
+    payload.findings.length === 0 ? /* @__PURE__ */ jsx("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__ */ jsx("div", { className: "overflow-x-auto rounded border border-kumo-line", children: /* @__PURE__ */ jsxs("table", { className: "w-full text-left text-sm", children: [
+      /* @__PURE__ */ jsx("thead", { className: "bg-kumo-tint", children: /* @__PURE__ */ jsxs("tr", { children: [
+        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Route" }),
+        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Rule" }),
+        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Severity" }),
+        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Message" })
+      ] }) }),
+      /* @__PURE__ */ jsx("tbody", { children: payload.findings.map((finding, i) => {
+        const routeInfo = routesByPath.get(finding.route);
+        return /* @__PURE__ */ jsxs("tr", { className: "border-t border-kumo-line", children: [
+          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx(RouteLinks, { finding, info: routeInfo }) }),
+          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx("code", { className: "rounded bg-kumo-tint px-1.5 py-0.5 font-mono text-xs", children: finding.rule_id }) }),
+          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx(SeverityBadge, { severity: finding.severity }) }),
+          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: finding.message })
+        ] }, i);
+      }) })
+    ] }) })
+  ] });
+}
+function RouteLinks({
+  finding,
+  info
+}) {
+  if (info === void 0) {
+    return /* @__PURE__ */ jsx("span", { className: "font-mono text-xs", children: finding.route });
+  }
+  return /* @__PURE__ */ jsxs("span", { className: "space-x-2", children: [
+    info.editUrl !== "" ? /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: info.editUrl,
+        className: "font-mono text-xs text-kumo-link hover:underline",
+        children: finding.route
+      }
+    ) : /* @__PURE__ */ jsx("span", { className: "font-mono text-xs", children: finding.route }),
+    info.publishedUrl !== "" && /* @__PURE__ */ jsx(
+      "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__ */ jsx("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__ */ jsx(
+    "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
+};
+export {
+  pages
+};

package/dist/configured.d.ts

@@ -1,5 +1,12 @@
 export interface ConfiguredPluginOptions {
+    /**
+     * emdash collections the Refresh button sweeps. Comes through from
+     * the descriptor's `options` field — see `seogeoPlugin({ collections })`
+     * in src/index.ts. When undefined, falls back to DEFAULT_COLLECTIONS
+     * (`["posts", "pages"]`).
+     */
+    collections?: readonly string[];
 }
-export declare function createPlugin(_options?: ConfiguredPluginOptions): unknown;
+export declare function createPlugin(options?: ConfiguredPluginOptions): unknown;
 export default createPlugin;
 //# sourceMappingURL=configured.d.ts.map

package/dist/configured.d.ts.map

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

package/dist/configured.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // src/adapter.ts
-function contentItemToEmdashDocument(content) {
+function adaptContentItem(content) {
   const route = deriveRoute(content);
   const title = stringOrEmpty(
     content.seo?.title ?? content.data["title"] ?? content.slug ?? content.id
@@ -29,7 +29,16 @@ function contentItemToEmdashDocument(content) {
   if (body !== null) {
     document.body = body;
   }
-  return document;
+  return {
+    document,
+    meta: {
+      id: content.id,
+      collection: content.type,
+      slug: content.slug,
+      status: content.status,
+      title
+    }
+  };
 }
 function deriveRoute(content) {
   if (typeof content.slug === "string" && content.slug.length > 0) {
@@ -65,9 +74,11 @@ function isPortableTextArray(value) {
 
 // src/plugin.ts
 async function handleAfterSaveConfigured(event, ctx, evaluator) {
-  const document = contentItemToEmdashDocument(event.content);
+  const adapted = adaptContentItem(event.content);
+  const document = adapted.document;
   const { kv, log } = ctx;
-  await kv.set(documentKey(document.route), document);
+  const stored = { document, meta: adapted.meta };
+  await kv.set(documentKey(document.route), stored);
   const result = await evaluator([document]);
   if (!result.ok) {
     log?.error?.(`afterSave evaluator failure (${result.reason})`, {
@@ -94,6 +105,7 @@ async function evaluateAndPersistAll(ctx, options) {
     errors: []
   };
   const documents = [];
+  const adaptedByRoute = /* @__PURE__ */ new Map();
   const documentRoutes = /* @__PURE__ */ new Set();
   for (const collection of collections) {
     let cursor;
@@ -104,9 +116,13 @@ async function evaluateAndPersistAll(ctx, options) {
           ...cursor === void 0 ? {} : { cursor }
         });
         for (const item of page.items) {
-          const document = contentItemToEmdashDocument(item);
-          documents.push(document);
-          documentRoutes.add(document.route);
+          const adapted = adaptContentItem(item);
+          documents.push(adapted.document);
+          documentRoutes.add(adapted.document.route);
+          adaptedByRoute.set(adapted.document.route, {
+            document: adapted.document,
+            meta: adapted.meta
+          });
         }
         cursor = page.hasMore ? page.cursor : void 0;
       } catch (err) {
@@ -117,8 +133,8 @@ async function evaluateAndPersistAll(ctx, options) {
     } while (cursor !== void 0);
   }
   summary.documentsScanned = documents.length;
-  for (const document of documents) {
-    await kv.set(documentKey(document.route), document);
+  for (const stored of adaptedByRoute.values()) {
+    await kv.set(documentKey(stored.document.route), stored);
   }
   const result = await options.evaluator(documents);
   if (!result.ok) {
@@ -154,8 +170,33 @@ function documentKey(route) {
   return `document:${normalized}`;
 }
 async function readAllDocuments(kv) {
+  return (await readAllStoredDocuments(kv)).map((s) => s.document);
+}
+async function readAllStoredDocuments(kv) {
   const entries = await kv.list("document:");
-  return entries.map((entry) => entry.value).filter((value) => value !== null);
+  const out = [];
+  for (const entry of entries) {
+    const value = entry.value;
+    if (value === null || typeof value !== "object") continue;
+    if ("document" in value && "meta" in value) {
+      out.push(value);
+      continue;
+    }
+    if ("route" in value) {
+      const document = value;
+      out.push({
+        document,
+        meta: {
+          id: document.route,
+          collection: "",
+          slug: null,
+          status: "",
+          title: document.title ?? ""
+        }
+      });
+    }
+  }
+  return out;
 }
 async function readFindings(kv, route) {
   const stored = await kv.get(findingsKey(route));
@@ -165,6 +206,97 @@ async function readFindings(kv, route) {
   return stored.findings;
 }
 
+// src/data-route.ts
+async function handleDataRoute(ctx, options) {
+  let summary = null;
+  if (options.refresh) {
+    summary = await evaluateAndPersistAll(ctx, {
+      collections: options.collections,
+      evaluator: options.evaluator
+    });
+  }
+  const payload = await buildFindingsPayload(ctx);
+  return { payload, summary };
+}
+async function buildFindingsPayload(ctx) {
+  const stored = await readAllStoredDocuments(ctx.kv);
+  const documents = /* @__PURE__ */ new Map();
+  for (const entry of stored) {
+    documents.set(entry.document.route, entry);
+  }
+  const entries = await ctx.kv.list(
+    "findings:"
+  );
+  const findings = [];
+  const sitewide = [];
+  const perRoute = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (entry.value === null) continue;
+    const route = entry.key.replace(/^findings:/, "");
+    if (route === "*") {
+      sitewide.push(...entry.value.findings);
+      continue;
+    }
+    let bucket = perRoute.get(route);
+    if (bucket === void 0) {
+      bucket = { findings: [], errors: 0, warnings: 0 };
+      perRoute.set(route, bucket);
+    }
+    for (const finding of entry.value.findings) {
+      bucket.findings.push(finding);
+      if (finding.severity === "error") bucket.errors += 1;
+      else if (finding.severity === "warning") bucket.warnings += 1;
+      findings.push({ ...finding, route });
+    }
+  }
+  findings.sort((a, b) => severityRank(a.severity) - severityRank(b.severity));
+  const siteUrl = ctx.site?.url ?? "";
+  const routes = [];
+  for (const [route, bucket] of perRoute) {
+    const stored2 = documents.get(route);
+    routes.push({
+      route,
+      title: stored2?.meta.title ?? route,
+      status: stored2?.meta.status ?? "",
+      collection: stored2?.meta.collection ?? "",
+      id: stored2?.meta.id ?? "",
+      editUrl: stored2 ? buildEditUrl(stored2.meta) : "",
+      publishedUrl: stored2 ? buildPublishedUrl(stored2.meta, route, siteUrl) : "",
+      findingCount: bucket.findings.length,
+      errorCount: bucket.errors,
+      warningCount: bucket.warnings
+    });
+  }
+  routes.sort((a, b) => b.errorCount - a.errorCount || a.route.localeCompare(b.route));
+  return {
+    routes,
+    findings,
+    totals: {
+      routes: routes.length,
+      findings: findings.length,
+      errors: findings.filter((f) => f.severity === "error").length,
+      warnings: findings.filter((f) => f.severity === "warning").length,
+      documentsIndexed: documents.size
+    },
+    sitewideFindings: sitewide
+  };
+}
+function severityRank(severity) {
+  if (severity === "error") return 0;
+  if (severity === "warning") return 1;
+  return 2;
+}
+function buildEditUrl(meta) {
+  if (meta.collection === "" || meta.id === "") return "";
+  return `/_emdash/admin/content/${encodeURIComponent(meta.collection)}/${encodeURIComponent(meta.id)}`;
+}
+function buildPublishedUrl(meta, route, siteUrl) {
+  if (meta.status !== "published") return "";
+  if (siteUrl === "") return "";
+  const trimmed = siteUrl.endsWith("/") ? siteUrl.slice(0, -1) : siteUrl;
+  return `${trimmed}${route}`;
+}
+
 // wasm/aexeo_emdash_bridge_bg.js
 var aexeo_emdash_bridge_bg_exports = {};
 __export(aexeo_emdash_bridge_bg_exports, {
@@ -357,24 +489,54 @@ var inProcessEvaluator = async (documents) => {
     return { ok: false, reason: "wasm_error", detail };
   }
 };
-function createPlugin(_options = {}) {
+function createPlugin(options = {}) {
+  const collections = options.collections === void 0 ? DEFAULT_COLLECTIONS : [...options.collections];
   return definePlugin({
     id: "aexeo-seogeo",
     version: "0.0.1",
     capabilities: ["read:content"],
     hooks: {
+      // afterSave processes one saved document at a time — collections
+      // list isn't needed here. The hook always runs regardless of
+      // which collection the document came from.
       "content:afterSave": (event, ctx) => handleAfterSaveConfigured(event, ctx, inProcessEvaluator)
     },
     routes: {
-      admin: { handler: handleAdminRoute }
+      // The Refresh sweep (handleAdminRoute → handleRefresh) is the
+      // one consumer of `collections`. Bind the resolved list here so
+      // every request handles the same set without re-reading options.
+      admin: {
+        handler: (ctx) => handleAdminRoute(ctx, collections)
+      },
+      // JSON data endpoint for the React adminEntry. Two routes:
+      //   POST /_emdash/api/plugins/aexeo-seogeo/data    — read current findings
+      //   POST /_emdash/api/plugins/aexeo-seogeo/refresh — sweep + read
+      // Returning JSON (not Block Kit blocks) lets the React
+      // <Findings/> component render proper <a href> links to the
+      // emdash edit page and the public site, which Block Kit can't
+      // express in any element type as of emdash 0.8.0.
+      data: {
+        handler: async (ctx) => (await handleDataRoute(ctx, {
+          collections,
+          evaluator: inProcessEvaluator,
+          refresh: false
+        })).payload
+      },
+      refresh: {
+        handler: (ctx) => handleDataRoute(ctx, {
+          collections,
+          evaluator: inProcessEvaluator,
+          refresh: true
+        })
+      }
     },
     admin: {
       pages: [
-        // emdash's /admin/plugins/<id> root navigates to the plugin's
-        // "/" page — without it, clicking the plugin in the meta list
-        // produces a "Not Found". Alias "/" to the findings page so
-        // the entry-point lands somewhere useful.
-        { path: "/", label: "SEO findings" },
+        // The root URL `/admin/plugins/<id>/` routes through the same
+        // dispatcher (handlePageLoad treats "" and "findings" as
+        // aliases). Listing "/" alongside "/findings" here would create
+        // duplicate "SEO findings" sidebar entries — that was the
+        // visible 0.1.0 / 0.1.1 bug fixed in 0.1.2.
         { path: "/findings", label: "SEO findings" },
         { path: "/document", label: "Document SEO" }
       ],
@@ -385,7 +547,7 @@ function createPlugin(_options = {}) {
   });
 }
 var configured_default = createPlugin;
-async function handleAdminRoute(ctx) {
+async function handleAdminRoute(ctx, collections) {
   const body = ctx.input;
   if (body.type === "page_load") {
     return handlePageLoad(ctx, body.page);
@@ -395,7 +557,7 @@ async function handleAdminRoute(ctx) {
       return renderDocumentPanel(ctx, body.value);
     }
     if (body.action_id === "refresh_findings") {
-      return handleRefresh(ctx);
+      return handleRefresh(ctx, collections);
     }
     if (body.action_id.startsWith("filter:")) {
       return renderFindingsPage(ctx);
@@ -426,11 +588,12 @@ async function handlePageLoad(ctx, page) {
   }
   return notFound(page);
 }
-async function handleRefresh(ctx) {
+async function handleRefresh(ctx, collections) {
   let summary;
   try {
     summary = await evaluateAndPersistAll(ctx, {
-      evaluator: inProcessEvaluator
+      evaluator: inProcessEvaluator,
+      collections
     });
   } catch (err) {
     const detail = err instanceof Error ? err.message : String(err);

package/dist/data-route.d.ts

@@ -0,0 +1,48 @@
+import type { EvaluatorFn, RefreshSummary, SandboxCtx } from "./plugin.js";
+import type { Finding } from "./types.js";
+export interface FindingsPayload {
+    routes: RouteSummary[];
+    findings: FindingRow[];
+    totals: {
+        routes: number;
+        findings: number;
+        errors: number;
+        warnings: number;
+        documentsIndexed: number;
+    };
+    sitewideFindings: Finding[];
+}
+export interface RouteSummary {
+    route: string;
+    title: string;
+    status: string;
+    collection: string;
+    id: string;
+    editUrl: string;
+    publishedUrl: string;
+    findingCount: number;
+    errorCount: number;
+    warningCount: number;
+}
+export interface FindingRow {
+    route: string;
+    rule_id: string;
+    severity: string;
+    message: string;
+    path: string;
+    line: number;
+    column: number;
+    scope: string;
+    suggestion: string | null;
+}
+interface DataRouteOptions {
+    collections: readonly string[];
+    evaluator: EvaluatorFn;
+    refresh: boolean;
+}
+export declare function handleDataRoute(ctx: SandboxCtx, options: DataRouteOptions): Promise<{
+    payload: FindingsPayload;
+    summary: RefreshSummary | null;
+}>;
+export {};
+//# sourceMappingURL=data-route.d.ts.map

package/dist/data-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-route.d.ts","sourceRoot":"","sources":["../src/data-route.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,UAAU,EAEX,MAAM,aAAa,CAAC;AAMrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,MAAM,WAAW,eAAe;IAG9B,MAAM,EAAE,YAAY,EAAE,CAAC;IAIvB,QAAQ,EAAE,UAAU,EAAE,CAAC;IAIvB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAIF,gBAAgB,EAAE,OAAO,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IAGd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IAIX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,WAAW,CAAC;IAIvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IACT,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC,CAAC,CAUD"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export interface ConfiguredPluginDescriptor {
     id: string;
     version: string;
     entrypoint: string;
+    adminEntry?: string;
     options: Record<string, unknown>;
     capabilities: readonly string[];
     allowedHosts?: readonly string[];
@@ -18,6 +19,27 @@ export interface ConfiguredPluginDescriptor {
     }[];
 }
 export interface SeogeoPluginOptions {
+    /**
+     * emdash collections the plugin sweeps when an admin clicks
+     * Refresh on the findings page. Order doesn't matter; the sweep
+     * iterates each collection sequentially and groups findings by
+     * document route. The per-document `content:afterSave` hook always
+     * runs regardless of this list — saving a document in any
+     * collection triggers an evaluation for that one document.
+     *
+     * Defaults to `["posts", "pages"]` (the slugs the
+     * `@emdash-cms/template-blog-cloudflare` template ships with).
+     * Override when your schema uses different collection slugs:
+     *
+     *     seogeoPlugin({ collections: ["posts", "guides", "products"] })
+     *
+     * Pointing this at a slug that doesn't exist in your schema is
+     * non-fatal: the bridge's `content.list` returns empty and the
+     * sweep records the missing collection in the Refresh summary's
+     * `errors` field. Safe to ship a superset for a project that may
+     * add collections later.
+     */
+    collections?: readonly string[];
 }
 export declare function seogeoPlugin(options?: SeogeoPluginOptions): ConfiguredPluginDescriptor;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAWtB,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,YAAY,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;CAGnC;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,0BAA0B,CA0B5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAWtB,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAOnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,YAAY,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,0BAA0B,CA+C5B"}

package/dist/index.js

@@ -57,17 +57,36 @@ function seogeoPlugin(options = {}) {
     // time — must match the package.json `exports["./configured"]`
     // entry.
     entrypoint: "@aeptus/aexeo-emdash/configured",
-    options: { ...options },
+    // React admin module — registers a custom <Findings/> component
+    // for /findings so the route column can render proper <a href>
+    // links. Block Kit can't express clickable links in any element
+    // type as of emdash 0.8.0. The React module's `pages` object is
+    // imported by emdash's admin registry codegen at build time; if
+    // the consumer's bundler doesn't pick up tsx (rare — every
+    // emdash adapter does), the rest of the plugin still works
+    // because /document and the dashboard widget stay on Block Kit.
+    adminEntry: "@aeptus/aexeo-emdash/admin",
+    // emdash's astro integration JSON-serializes `options` and emits
+    // an importer that does `createPlugin(<options>)` at boot.
+    // Anything we put here is what the runtime entry's createPlugin
+    // receives. Spread to a plain object so readonly arrays survive
+    // the structured-clone semantics of that codegen.
+    options: {
+      ...options.collections === void 0 ? {} : { collections: [...options.collections] }
+    },
     capabilities: [
       "read:content",
       "read:schema",
       "kv:seogeo-baselines"
     ],
+    // adminPages drives the admin sidebar — one nav entry per item.
+    // Don't list "/" alongside "/findings": both would render as
+    // duplicate "SEO findings" links in the sidebar (0.1.0 / 0.1.1
+    // shipped with this duplicate; fixed in 0.1.2). The root URL
+    // /admin/plugins/<id>/ still routes correctly because the
+    // dispatcher in src/configured.ts treats "" and "findings" as
+    // the same page.
     adminPages: [
-      // "/" alias is required so emdash's /admin/plugins/<id> root
-      // doesn't 404 — that page is where the meta /admin/plugins
-      // list links to when an operator clicks the plugin entry.
-      { path: "/", label: "SEO findings" },
       { path: "/findings", label: "SEO findings" },
       { path: "/document", label: "Document SEO" }
     ],

package/dist/plugin.d.ts

@@ -1,6 +1,10 @@
 import type { EmdashDocument, Finding } from "./types.js";
-import { type EmdashContentItem } from "./adapter.js";
+import { type EmdashContentItem, type EmdashContentMeta } from "./adapter.js";
 import type { SidecarHttp } from "./sidecar.js";
+export interface StoredDocument {
+    document: EmdashDocument;
+    meta: EmdashContentMeta;
+}
 export declare function buildCapabilities(evaluatorHost: string | null): readonly string[];
 export declare function buildAllowedHosts(evaluatorHost: string | null): readonly string[];
 export declare const capabilities: readonly string[];
@@ -37,6 +41,11 @@ export interface SandboxCtx {
     kv: KvNamespace;
     http: SidecarHttp;
     content: SandboxContentApi;
+    site?: {
+        url: string;
+        name?: string;
+        locale?: string;
+    };
     log?: {
         info(msg: string, data?: unknown): void;
         warn(msg: string, data?: unknown): void;
@@ -73,5 +82,6 @@ export declare function evaluateAndPersistAll(ctx: SandboxCtx, options: {
 export declare function findingsKey(route: string): string;
 export declare function documentKey(route: string): string;
 export declare function readAllDocuments(kv: KvNamespace): Promise<EmdashDocument[]>;
+export declare function readAllStoredDocuments(kv: KvNamespace): Promise<StoredDocument[]>;
 export declare function readFindings(kv: KvNamespace, route: string): Promise<Finding[]>;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAGvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAqCD,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,SAAS,MAAM,EAAE,CAKnB;AASD,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,SAAS,MAAM,EAAE,CAMnB;AAKD,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAqB,CAAC;AAWhE,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAC3D;AAcD,eAAO,MAAM,cAAc,yBAAyB,CAAC;AACrD,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAUtC;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf;AAOD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,iBAAiB,CAAC;IAK3B,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAC1C,CAAC;CACH;AAOD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AA0BD,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAMD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,WAAW,GACrB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAMD,eAAO,MAAM,mBAAmB,6BAA8B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAKD,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAelD,MAAM,MAAM,WAAW,GAAG,CACxB,SAAS,EAAE,SAAS,cAAc,EAAE,KACjC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAMhC,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,WAAW,CAAA;CAAE,GACnE,OAAO,CAAC,cAAc,CAAC,CAwFzB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3B;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CA+B3B;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,EAAE,CAAC,CAMpB"}

package/dist/sandbox-entry.js

@@ -1,5 +1,5 @@
 // src/adapter.ts
-function contentItemToEmdashDocument(content) {
+function adaptContentItem(content) {
   const route = deriveRoute(content);
   const title = stringOrEmpty(
     content.seo?.title ?? content.data["title"] ?? content.slug ?? content.id
@@ -23,7 +23,16 @@ function contentItemToEmdashDocument(content) {
   if (body !== null) {
     document.body = body;
   }
-  return document;
+  return {
+    document,
+    meta: {
+      id: content.id,
+      collection: content.type,
+      slug: content.slug,
+      status: content.status,
+      title
+    }
+  };
 }
 function deriveRoute(content) {
   if (typeof content.slug === "string" && content.slug.length > 0) {
@@ -88,6 +97,7 @@ async function evaluateAndPersistAll(ctx, options) {
     errors: []
   };
   const documents = [];
+  const adaptedByRoute = /* @__PURE__ */ new Map();
   const documentRoutes = /* @__PURE__ */ new Set();
   for (const collection of collections) {
     let cursor;
@@ -98,9 +108,13 @@ async function evaluateAndPersistAll(ctx, options) {
           ...cursor === void 0 ? {} : { cursor }
         });
         for (const item of page.items) {
-          const document = contentItemToEmdashDocument(item);
-          documents.push(document);
-          documentRoutes.add(document.route);
+          const adapted = adaptContentItem(item);
+          documents.push(adapted.document);
+          documentRoutes.add(adapted.document.route);
+          adaptedByRoute.set(adapted.document.route, {
+            document: adapted.document,
+            meta: adapted.meta
+          });
         }
         cursor = page.hasMore ? page.cursor : void 0;
       } catch (err) {
@@ -111,8 +125,8 @@ async function evaluateAndPersistAll(ctx, options) {
     } while (cursor !== void 0);
   }
   summary.documentsScanned = documents.length;
-  for (const document of documents) {
-    await kv.set(documentKey(document.route), document);
+  for (const stored of adaptedByRoute.values()) {
+    await kv.set(documentKey(stored.document.route), stored);
   }
   const result = await options.evaluator(documents);
   if (!result.ok) {
@@ -148,8 +162,33 @@ function documentKey(route) {
   return `document:${normalized}`;
 }
 async function readAllDocuments(kv) {
+  return (await readAllStoredDocuments(kv)).map((s) => s.document);
+}
+async function readAllStoredDocuments(kv) {
   const entries = await kv.list("document:");
-  return entries.map((entry) => entry.value).filter((value) => value !== null);
+  const out = [];
+  for (const entry of entries) {
+    const value = entry.value;
+    if (value === null || typeof value !== "object") continue;
+    if ("document" in value && "meta" in value) {
+      out.push(value);
+      continue;
+    }
+    if ("route" in value) {
+      const document = value;
+      out.push({
+        document,
+        meta: {
+          id: document.route,
+          collection: "",
+          slug: null,
+          status: "",
+          title: document.title ?? ""
+        }
+      });
+    }
+  }
+  return out;
 }
 async function readFindings(kv, route) {
   const stored = await kv.get(findingsKey(route));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeptus/aexeo-emdash",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Aexeo seogeo SEO/GEO content evaluator as an emdash plugin",
   "license": "MIT",
   "author": "Aexeo",
@@ -36,6 +36,11 @@
       "import": "./dist/configured.js",
       "default": "./dist/configured.js"
     },
+    "./admin": {
+      "types": "./dist/admin.d.ts",
+      "import": "./dist/admin.js",
+      "default": "./dist/admin.js"
+    },
     "./sandbox": {
       "types": "./dist/sandbox-entry.d.ts",
       "import": "./dist/sandbox-entry.js",
@@ -59,7 +64,8 @@
   },
   "peerDependencies": {
     "@emdash-cms/core": "*",
-    "emdash": ">=0.7.0"
+    "emdash": ">=0.7.0",
+    "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@emdash-cms/core": {
@@ -67,12 +73,17 @@
     },
     "emdash": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
     "emdash": "^0.7.0",
     "esbuild": "^0.28.0",
+    "react": "^19.2.5",
     "typescript": "^5.6.0"
   }
 }