@aeptus/aexeo-emdash 0.8.17 → 0.8.19

package/dist/configured.js

@@ -5,15 +5,42 @@ var __export = (target, all) => {
 };
 
 // src/adapter.ts
-function adaptContentItem(content) {
-  const route = deriveRoute(content);
+async function adaptContentItemWithContext(content, contentApi, defaultLocale) {
+  const publicUrl = content.status === "published" ? await contentApi.getPublicUrl(content.type, content.id) : null;
+  const route = publicUrl === null ? deriveRoute(content) : routeFromPublicUrl(publicUrl);
+  const adapted = adaptContentItem(content, {
+    route,
+    publicUrl,
+    ...defaultLocale === void 0 ? {} : { defaultLocale }
+  });
+  const translationSet = await contentApi.getTranslations(
+    content.type,
+    content.id
+  );
+  const alternates = await Promise.all(
+    translationSet.translations.filter(
+      (translation) => translation.status === "published" && typeof translation.locale === "string" && translation.locale.length > 0
+    ).map(async (translation) => {
+      const href = translation.id === content.id ? publicUrl : await contentApi.getPublicUrl(content.type, translation.id);
+      if (href === null) return null;
+      return { lang: translation.locale, href };
+    })
+  );
+  const uniqueAlternates = /* @__PURE__ */ new Map();
+  for (const alternate of alternates) {
+    if (alternate !== null) uniqueAlternates.set(alternate.lang, alternate);
+  }
+  if (uniqueAlternates.size > 0) {
+    adapted.document.alternates = [...uniqueAlternates.values()];
+  }
+  return adapted;
+}
+function adaptContentItem(content, options = {}) {
+  const route = options.route ?? deriveRoute(content);
   const title = stringOrEmpty(
     content.seo?.title ?? content.data["title"] ?? content.slug ?? content.id
   );
-  const document = {
-    route,
-    title
-  };
+  const document = { route, title };
   const description = content.seo?.description ?? content.data["description"];
   if (typeof description === "string" && description.length > 0) {
     document.description = description;
@@ -22,13 +49,12 @@ function adaptContentItem(content) {
   if (typeof canonical === "string" && canonical.length > 0) {
     document.canonical = canonical;
   }
-  if (content.locale !== null) {
-    document.lang = content.locale;
+  const locale = content.locale || options.defaultLocale;
+  if (typeof locale === "string" && locale.length > 0) {
+    document.lang = locale;
   }
   const body = extractPortableText(content.data);
-  if (body !== null) {
-    document.body = body;
-  }
+  if (body !== null) document.body = body;
   return {
     document,
     meta: {
@@ -36,49 +62,160 @@ function adaptContentItem(content) {
       collection: content.type,
       slug: content.slug,
       status: content.status,
-      title
+      title,
+      publicUrl: options.publicUrl ?? null
     }
   };
 }
 function deriveRoute(content) {
-  if (typeof content.slug === "string" && content.slug.length > 0) {
-    return content.slug.startsWith("/") ? content.slug : `/${content.slug}`;
+  return `/${encodeURIComponent(content.type)}/${encodeURIComponent(content.id)}`;
+}
+function routeFromPublicUrl(publicUrl) {
+  try {
+    return new URL(publicUrl).pathname || "/";
+  } catch (cause) {
+    throw new Error(`EmDash returned an invalid public URL: ${publicUrl}`, {
+      cause
+    });
   }
-  return `/${content.type}/${content.id}`;
 }
 function stringOrEmpty(value) {
   return typeof value === "string" ? value : "";
 }
 function extractPortableText(data) {
-  const candidates = ["body", "content"];
-  for (const slug of candidates) {
+  for (const slug of ["body", "content"]) {
     const value = data[slug];
-    if (isPortableTextArray(value)) {
-      return value;
+    if (isPortableTextArray(value)) return value;
+    if (isEmdashBlocksArray(value, slug)) return blocksToPortableText(value);
+    if (typeof value === "string" && value.trim().length > 0) {
+      return [portableTextBlock(value.trim(), `${slug}-text`)];
     }
   }
-  for (const value of Object.values(data)) {
-    if (isPortableTextArray(value)) {
-      return value;
-    }
+  const blocks = data["blocks"];
+  if (isPortableTextArray(blocks)) return blocks;
+  if (isEmdashBlocksArray(blocks, "blocks")) return blocksToPortableText(blocks);
+  for (const [field, value] of Object.entries(data)) {
+    if (field === "body" || field === "content" || field === "blocks") continue;
+    if (isPortableTextArray(value)) return value;
+    if (isEmdashBlocksArray(value, field)) return blocksToPortableText(value);
   }
   return null;
 }
 function isPortableTextArray(value) {
-  if (!Array.isArray(value) || value.length === 0) {
-    return false;
+  return Array.isArray(value) && value.length > 0 && value.every(
+    (item) => isRecord(item) && item["_type"] === "block" && Array.isArray(item["children"]) && item["children"].every(
+      (child) => isRecord(child) && typeof child["text"] === "string"
+    )
+  );
+}
+function isEmdashBlocksArray(value, field) {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.every(
+    (item) => isRecord(item) && typeof item["_type"] === "string" && typeof item["_key"] === "string" && (typeof item["_version"] === "number" || field === "blocks")
+  );
+}
+function blocksToPortableText(blocks) {
+  const paragraphs = [];
+  for (const block of blocks) {
+    const segments = [];
+    collectText(block, "", segments);
+    const text = segments.map((segment) => segment.trim()).filter(Boolean).join(" ");
+    if (text.length > 0) {
+      paragraphs.push(portableTextBlock(text, stringOrEmpty(block["_key"])));
+    }
   }
-  const first = value[0];
-  return typeof first === "object" && first !== null && "_type" in first && typeof first._type === "string";
+  return paragraphs;
+}
+function collectText(value, key, out) {
+  if (typeof value === "string") {
+    if (!isStructuralField(key) && value.trim().length > 0) out.push(value);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectText(item, key, out);
+    return;
+  }
+  if (!isRecord(value)) return;
+  for (const [childKey, childValue] of Object.entries(value)) {
+    if (isStructuralField(childKey)) continue;
+    collectText(childValue, childKey, out);
+  }
+}
+var STRUCTURAL_FIELDS = /* @__PURE__ */ new Set([
+  "_key",
+  "_ref",
+  "_type",
+  "_version",
+  "asset",
+  "align",
+  "alignment",
+  "autoplay",
+  "color",
+  "controls",
+  "focalpoint",
+  "height",
+  "href",
+  "id",
+  "layout",
+  "level",
+  "loop",
+  "markdefs",
+  "marks",
+  "mime_type",
+  "mimetype",
+  "position",
+  "rel",
+  "size",
+  "src",
+  "style",
+  "target",
+  "theme",
+  "tone",
+  "url",
+  "variant",
+  "width"
+]);
+function isStructuralField(key) {
+  const normalized = key.toLowerCase();
+  return normalized.startsWith("_") || STRUCTURAL_FIELDS.has(normalized);
+}
+function portableTextBlock(text, key) {
+  return {
+    _type: "block",
+    ...key.length === 0 ? {} : { _key: key },
+    children: [
+      {
+        _type: "span",
+        ...key.length === 0 ? {} : { _key: `${key}-text` },
+        text,
+        marks: []
+      }
+    ]
+  };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // src/plugin.ts
+var SETTINGS_TOKEN_KEY = "eval_token";
+var PLUGIN_SETTINGS_SCHEMA = {
+  [SETTINGS_TOKEN_KEY]: {
+    type: "secret",
+    label: "EVAL_TOKEN",
+    description: "Bearer token for your aexeo-crawl-worker Worker. Encrypted at rest by the emdash host."
+  }
+};
 async function handleAfterSaveConfigured(event, ctx, evaluator, suppressionFilter) {
-  const adapted = adaptContentItem(event.content);
+  const adapted = await adaptContentItemWithContext(
+    event.content,
+    ctx.content,
+    ctx.site?.locale
+  );
   const document = adapted.document;
   const { kv, log } = ctx;
   const stored = { document, meta: adapted.meta };
-  await kv.set(documentKey(document.route), stored);
+  await persistDocument(ctx, stored);
   const result = await evaluator([document]);
   if (!result.ok) {
     log?.error?.(`afterSave evaluator failure (${result.reason})`, {
@@ -125,7 +262,11 @@ async function evaluateAndPersistAll(ctx, options) {
           ...cursor === void 0 ? {} : { cursor }
         });
         for (const item of page.items) {
-          const adapted = adaptContentItem(item);
+          const adapted = await adaptContentItemWithContext(
+            item,
+            ctx.content,
+            ctx.site?.locale
+          );
           documents.push(adapted.document);
           documentRoutes.add(adapted.document.route);
           adaptedByRoute.set(adapted.document.route, {
@@ -177,8 +318,57 @@ async function evaluateAndPersistAll(ctx, options) {
     totalAfterSuppression += filtered.length;
   }
   summary.totalFindings = totalAfterSuppression;
+  if (summary.errors.length === 0) {
+    await removeStaleDocuments(ctx, collections, documentRoutes);
+  }
   return summary;
 }
+async function persistDocument(ctx, stored) {
+  const route = stored.document.route;
+  const entries = await ctx.kv.list("document:");
+  for (const entry of entries) {
+    const previous = toStoredDocument(entry.value);
+    if (previous === null || previous.document.route === route || previous.meta.id !== stored.meta.id || previous.meta.collection !== stored.meta.collection) {
+      continue;
+    }
+    await ctx.kv.delete(entry.key);
+    await ctx.kv.delete(findingsKey(previous.document.route));
+  }
+  await ctx.kv.set(documentKey(route), stored);
+}
+async function removeStaleDocuments(ctx, collections, currentRoutes) {
+  const scannedCollections = new Set(collections);
+  const entries = await ctx.kv.list("document:");
+  for (const entry of entries) {
+    const stored = toStoredDocument(entry.value);
+    if (stored === null || !scannedCollections.has(stored.meta.collection) || currentRoutes.has(stored.document.route)) {
+      continue;
+    }
+    await ctx.kv.delete(entry.key);
+    await ctx.kv.delete(findingsKey(stored.document.route));
+  }
+}
+function toStoredDocument(value) {
+  if (value === null || typeof value !== "object") return null;
+  if ("document" in value && "meta" in value && value.document !== null && typeof value.document === "object" && "route" in value.document && typeof value.document.route === "string" && value.meta !== null && typeof value.meta === "object") {
+    return value;
+  }
+  if ("route" in value && typeof value.route === "string") {
+    const document = value;
+    return {
+      document,
+      meta: {
+        id: document.route,
+        collection: "",
+        slug: null,
+        status: "",
+        title: document.title ?? "",
+        publicUrl: null
+      }
+    };
+  }
+  return null;
+}
 function findingsKey(route) {
   const normalized = route === "" || route === "/" ? "/" : route;
   return `findings:${normalized}`;
@@ -199,34 +389,301 @@ async function readAllStoredDocuments(kv) {
   const entries = await kv.list("document:");
   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);
+    const stored = toStoredDocument(entry.value);
+    if (stored !== null) out.push(stored);
+  }
+  return out;
+}
+async function readFindings(kv, route) {
+  const stored = await kv.get(findingsKey(route));
+  if (stored === null) {
+    return [];
+  }
+  return stored.findings;
+}
+
+// src/findings-view.ts
+function normalizeInteraction(input) {
+  if (!input || typeof input !== "object") {
+    return { type: "page_load", page: "/findings" };
+  }
+  const raw = input;
+  if (raw.type === "page_load") {
+    return {
+      type: "page_load",
+      page: typeof raw.page === "string" && raw.page.length > 0 ? raw.page : "/findings"
+    };
+  }
+  if (raw.type === "block_action") {
+    return {
+      type: "block_action",
+      action_id: typeof raw.action_id === "string" ? raw.action_id : "",
+      ...typeof raw.block_id === "string" ? { block_id: raw.block_id } : {},
+      value: raw.value
+    };
+  }
+  if (raw.type === "form_submit") {
+    return {
+      type: "form_submit",
+      action_id: typeof raw.action_id === "string" ? raw.action_id : "",
+      ...typeof raw.block_id === "string" ? { block_id: raw.block_id } : {},
+      values: raw.values && typeof raw.values === "object" ? raw.values : {}
+    };
+  }
+  return { type: "page_load", page: "/findings" };
+}
+async function handleRefresh(options) {
+  let summary;
+  try {
+    summary = await evaluateAndPersistAll(options.ctx, {
+      collections: options.collections,
+      evaluator: options.evaluator,
+      // Always forwarded. See RefreshOptions.suppressionFilter.
+      suppressionFilter: options.suppressionFilter
+    });
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    const message = `Refresh failed: ${detail}`;
+    return {
+      blocks: [
+        { type: "header", text: "SEO findings" },
+        {
+          type: "banner",
+          title: message,
+          variant: options.tuning.refreshFailureVariant
+        }
+      ],
+      toast: { message, type: "error" }
+    };
+  }
+  const refreshed = await renderFindingsPage(options.ctx.kv, options.tuning);
+  const toastMessage = summary.errors.length === 0 ? `Refreshed ${summary.routesUpdated} routes (${summary.totalFindings} findings across ${summary.documentsScanned} documents)` : `Refresh completed with ${summary.errors.length} errors \u2014 see banner`;
+  if (summary.errors.length > 0) {
+    refreshed.blocks.unshift({
+      type: "banner",
+      title: `Refresh issues: ${summary.errors.join(" \u2022 ")}`,
+      variant: "alert"
+    });
+  }
+  return {
+    ...refreshed,
+    toast: {
+      message: toastMessage,
+      type: summary.errors.length === 0 ? "success" : "info"
+    }
+  };
+}
+async function readAllFindings(kv) {
+  const entries = await kv.list(
+    "findings:"
+  );
+  const out = [];
+  for (const entry of entries) {
+    if (entry.value === null) {
       continue;
     }
-    if ("route" in value) {
-      const document = value;
-      out.push({
-        document,
-        meta: {
-          id: document.route,
-          collection: "",
-          slug: null,
-          status: "",
-          title: document.title ?? ""
-        }
-      });
+    const route = entry.key.replace(/^findings:/, "");
+    for (const finding of entry.value.findings) {
+      out.push({ ...finding, document_route: route });
     }
   }
   return out;
 }
-async function readFindings(kv, route) {
-  const stored = await kv.get(findingsKey(route));
-  if (stored === null) {
-    return [];
-  }
-  return stored.findings;
+function severityFirst(a, b) {
+  const rank = (severity) => severity === "error" ? 0 : 1;
+  const diff = rank(a.severity) - rank(b.severity);
+  if (diff !== 0) {
+    return diff;
+  }
+  return a.rule_id.localeCompare(b.rule_id);
+}
+function uniqueRoutes(rows) {
+  const routes = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    routes.add(row.document_route);
+  }
+  return [...routes].sort();
+}
+async function renderFindingsPage(kv, tuning) {
+  const findings = await readAllFindings(kv);
+  const errors = findings.filter((finding) => finding.severity === "error");
+  const warnings = findings.filter(
+    (finding) => finding.severity === "warning"
+  );
+  const sorted = [...findings].sort(severityFirst);
+  const routes = uniqueRoutes(findings);
+  const blocks = [
+    { type: "header", text: "SEO findings" },
+    {
+      type: "context",
+      text: findings.length === 0 ? "No findings yet \u2014 click Refresh to evaluate the site." : `${findings.length} findings across ${routes.length} routes \u2014 ${errors.length} errors, ${warnings.length} warnings.`
+    },
+    { type: "divider" },
+    {
+      type: "actions",
+      elements: [
+        // Refresh evaluates every configured entry. Pressing it lists
+        // content via the live in-request bridge, evaluates it, and
+        // writes findings back to KV (with suppressions applied).
+        {
+          type: "button",
+          label: "Refresh",
+          action_id: "refresh_findings",
+          style: "primary"
+        },
+        { type: "button", label: "All", action_id: "filter:all" },
+        { type: "button", label: "Errors only", action_id: "filter:errors" },
+        {
+          type: "button",
+          label: "Warnings only",
+          action_id: "filter:warnings"
+        }
+      ]
+    },
+    sorted.length === 0 ? {
+      type: "context",
+      text: tuning.emptyFindingsText
+    } : findingsTable(sorted)
+  ];
+  if (routes.length > 0) {
+    blocks.push({
+      type: "form",
+      fields: [
+        {
+          type: "select",
+          action_id: "route_picker",
+          label: "Document to inspect",
+          options: routes.map((route) => ({ label: route, value: route }))
+        }
+      ],
+      submit: { label: "View document SEO", action_id: "view_document" }
+    });
+  }
+  return { blocks };
+}
+function findingsTable(rows) {
+  return {
+    type: "table",
+    columns: [
+      { key: "route", label: "Route" },
+      { key: "rule", label: "Rule", format: "code" },
+      { key: "severity", label: "Severity", format: "badge" },
+      { key: "message", label: "Message" }
+    ],
+    rows: rows.map((row) => ({
+      route: row.document_route,
+      rule: row.rule_id,
+      severity: row.severity,
+      message: row.message
+    }))
+  };
+}
+async function renderScoreWidget(kv, tuning) {
+  const documents = await readAllDocuments(kv);
+  if (documents.length === 0) {
+    return {
+      blocks: [
+        { type: "header", text: "SEO score" },
+        {
+          type: "context",
+          text: tuning.emptyScoreText
+        }
+      ]
+    };
+  }
+  const score = await tuning.score(documents, kv);
+  const blocks = [
+    {
+      type: "stats",
+      items: [
+        { label: "Overall", value: `${score.overall_score}` },
+        { label: "Citation", value: `${score.citation_readiness_score}` },
+        {
+          label: tuning.truthLabel(score),
+          value: `${score.truth_consistency_score}`
+        },
+        { label: "Answers", value: `${score.answer_pack_score}` }
+      ]
+    }
+  ];
+  if (score.overall_score < 60) {
+    blocks.unshift({
+      type: "banner",
+      title: `Site score is ${score.overall_score} \u2014 below the 60 quality threshold`,
+      variant: "alert"
+    });
+  }
+  if (score.blockers.length > 0) {
+    blocks.push({
+      type: "context",
+      text: topBlockersLine(score)
+    });
+  }
+  return { blocks };
+}
+function topBlockersLine(score) {
+  const top = score.blockers.slice(0, 3).map((blocker) => blocker.message);
+  if (top.length === 0) {
+    return "No blockers identified.";
+  }
+  return `Top blockers: ${top.join(" \u2022 ")}`;
+}
+async function renderDocumentPanel(kv, route) {
+  if (route === void 0) {
+    return {
+      blocks: [
+        { type: "header", text: "Document SEO" },
+        {
+          type: "context",
+          text: "Pick a document from the SEO findings list to see its rule findings here."
+        }
+      ]
+    };
+  }
+  const findings = await readFindings(kv, route);
+  const errors = findings.filter((finding) => finding.severity === "error");
+  const warnings = findings.filter(
+    (finding) => finding.severity === "warning"
+  );
+  const sorted = [...findings].sort(severityFirst);
+  return {
+    blocks: [
+      { type: "header", text: `Document SEO \u2014 ${route}` },
+      {
+        type: "context",
+        text: findings.length === 0 ? `No findings for ${route} \u2014 the document is currently clean.` : `${findings.length} findings \u2014 ${errors.length} errors, ${warnings.length} warnings.`
+      },
+      ...findings.length === 0 ? [] : [{ type: "divider" }, documentFindingsTable(sorted)]
+    ]
+  };
+}
+function documentFindingsTable(findings) {
+  return {
+    type: "table",
+    columns: [
+      { key: "rule", label: "Rule", format: "code" },
+      { key: "severity", label: "Severity", format: "badge" },
+      { key: "message", label: "Message" },
+      { key: "block", label: "Block", format: "code" }
+    ],
+    rows: findings.map((finding) => ({
+      rule: finding.rule_id,
+      severity: finding.severity,
+      message: finding.message,
+      // The bridge stamps every Portable Text block with id + data-pt-key
+      // when rendering; surfacing the path:line locator here lets authors
+      // locate the failing block via the editor's ⌘-F.
+      block: `${finding.path}:${finding.line}`
+    }))
+  };
+}
+function notFound(page) {
+  return {
+    blocks: [
+      { type: "header", text: "Not found" },
+      { type: "context", text: `unknown page: ${page}` }
+    ]
+  };
 }
 
 // wasm/aexeo_emdash_bridge_bg.js
@@ -559,7 +1016,6 @@ async function buildFindingsPayload(ctx) {
     }
   }
   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);
@@ -570,7 +1026,7 @@ async function buildFindingsPayload(ctx) {
       collection: stored2?.meta.collection ?? "",
       id: stored2?.meta.id ?? "",
       editUrl: stored2 ? buildEditUrl(stored2.meta) : "",
-      publishedUrl: stored2 ? buildPublishedUrl(stored2.meta, route, siteUrl) : "",
+      publishedUrl: stored2?.meta.publicUrl ?? "",
       findingCount: bucket.findings.length,
       errorCount: bucket.errors,
       warningCount: bucket.warnings
@@ -696,12 +1152,6 @@ 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}`;
-}
 
 // src/facts-route.ts
 import { PluginRouteError } from "emdash";
@@ -854,11 +1304,11 @@ async function checkWikipedia(input, fetcher) {
     const descriptions = body[2];
     const urls = body[3];
     if (!Array.isArray(titles) || !Array.isArray(urls) || titles.length === 0) {
-      return notFound("wikipedia");
+      return notFound2("wikipedia");
     }
     const title = String(titles[0]);
     if (!fuzzyMatch(title, input.name)) {
-      return notFound("wikipedia");
+      return notFound2("wikipedia");
     }
     const articleUrl = String(urls[0] ?? "");
     const description = Array.isArray(descriptions) ? String(descriptions[0] ?? "") : "";
@@ -884,11 +1334,11 @@ async function checkWikidata(input, fetcher) {
     const body = await res.json();
     const top = body.search?.[0];
     if (!top || typeof top.id !== "string") {
-      return notFound("wikidata");
+      return notFound2("wikidata");
     }
     const label = top.label ?? input.name;
     if (!fuzzyMatch(label, input.name)) {
-      return notFound("wikidata");
+      return notFound2("wikidata");
     }
     return found("wikidata", {
       label: `${top.id}${top.label ? ` \u2014 ${top.label}` : ""}`,
@@ -914,7 +1364,7 @@ async function checkGitHub(input, fetcher) {
       // it the API can return either v3 or experimental shapes.
       headers: { Accept: "application/vnd.github+json" }
     });
-    if (res.status === 404) return notFound("github");
+    if (res.status === 404) return notFound2("github");
     if (res.status === 403 || res.status === 429) {
       return unreachable("github", "rate-limited (try Refresh later)");
     }
@@ -946,7 +1396,7 @@ async function checkRdap(input, fetcher) {
   const url = `https://rdap.org/domain/${encodeURIComponent(host)}`;
   try {
     const res = await timedFetch(fetcher, url);
-    if (res.status === 404) return notFound("rdap");
+    if (res.status === 404) return notFound2("rdap");
     if (!res.ok) return unreachable("rdap", `HTTP ${res.status}`);
     const body = await res.json();
     const reg = (body.events ?? []).find(
@@ -983,13 +1433,13 @@ async function checkCommonCrawl(input, fetcher) {
   url.searchParams.set("limit", "1");
   try {
     const res = await timedFetch(fetcher, url.toString());
-    if (res.status === 404) return notFound("common_crawl");
+    if (res.status === 404) return notFound2("common_crawl");
     if (!res.ok) return unreachable("common_crawl", `HTTP ${res.status}`);
     const text = (await res.text()).trim();
-    if (text.length === 0) return notFound("common_crawl");
+    if (text.length === 0) return notFound2("common_crawl");
     let firstLine = text.split("\n")[0];
     if (firstLine === void 0 || firstLine.length === 0) {
-      return notFound("common_crawl");
+      return notFound2("common_crawl");
     }
     let entry;
     try {
@@ -1031,7 +1481,7 @@ function found(source, details) {
   if (details.extra !== void 0) result.extra = details.extra;
   return result;
 }
-function notFound(source) {
+function notFound2(source) {
   return { source, status: "not_found", checkedAt: nowIso() };
 }
 function unreachable(source, error) {
@@ -1100,7 +1550,7 @@ async function handlePresenceRoute(ctx) {
     case "data":
       return await handleData2(ctx);
     case "refresh":
-      return await handleRefresh(ctx);
+      return await handleRefresh2(ctx);
     default:
       throw PluginRouteError2.badRequest(
         `unknown presence route kind: ${String(body.kind)}`
@@ -1127,7 +1577,7 @@ async function handleData2(ctx) {
   const state = ageMs !== null && ageMs > CACHE_TTL_MS ? "stale" : "fresh";
   return payload(state, cached.results, cached.generatedAt, entity.name);
 }
-async function handleRefresh(ctx) {
+async function handleRefresh2(ctx) {
   const manifest = await readStoredFacts(ctx.kv);
   if (manifest === null) {
     return payload("no_manifest", [], null, null);
@@ -1215,7 +1665,7 @@ function globToMatcher(pattern) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.17";
+var PACKAGE_VERSION = "0.8.19";
 
 // src/configured.ts
 import { definePlugin } from "emdash";
@@ -1284,7 +1734,7 @@ function createPlugin(options = {}) {
   return definePlugin({
     id: "aexeo-emdash",
     version: PACKAGE_VERSION,
-    capabilities: ["read:content"],
+    capabilities: ["content:read"],
     hooks: {
       // afterSave processes one saved document at a time — collections
       // list isn't needed here. The hook always runs regardless of
@@ -1301,7 +1751,7 @@ function createPlugin(options = {}) {
       // 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)
+        handler: (ctx) => handleAdminRoute(ctx, collections, suppressionFilter)
       },
       // JSON data endpoint for the React adminEntry. Two routes:
       //   POST /_emdash/api/plugins/aexeo-emdash/data    — read current findings
@@ -1371,246 +1821,59 @@ function createPlugin(options = {}) {
   });
 }
 var configured_default = createPlugin;
-function normalizeInteraction(input) {
-  if (!input || typeof input !== "object") {
-    return { type: "page_load", page: "/findings" };
-  }
-  const raw = input;
-  if (raw.type === "page_load") {
-    return {
-      type: "page_load",
-      page: typeof raw.page === "string" && raw.page.length > 0 ? raw.page : "/findings"
-    };
-  }
-  if (raw.type === "block_action") {
-    return {
-      type: "block_action",
-      action_id: typeof raw.action_id === "string" ? raw.action_id : "",
-      ...typeof raw.block_id === "string" ? { block_id: raw.block_id } : {},
-      value: raw.value
-    };
-  }
-  if (raw.type === "form_submit") {
-    return {
-      type: "form_submit",
-      action_id: typeof raw.action_id === "string" ? raw.action_id : "",
-      ...typeof raw.block_id === "string" ? { block_id: raw.block_id } : {},
-      values: raw.values && typeof raw.values === "object" ? raw.values : {}
-    };
-  }
-  return { type: "page_load", page: "/findings" };
-}
-async function handleAdminRoute(ctx, collections) {
+var adminViewTuning = {
+  emptyFindingsText: "Once a Refresh runs, findings will list here.",
+  emptyScoreText: "No documents indexed \u2014 click Refresh on the Aexeo findings page.",
+  refreshFailureVariant: "error",
+  score: async (documents, kv) => scoreLocally(documents, await readStoredFacts(kv)),
+  truthLabel: formatTruthLabel
+};
+async function handleAdminRoute(ctx, collections, suppressionFilter) {
   const body = normalizeInteraction(ctx.input);
   if (body.type === "page_load") {
     return handlePageLoad(ctx, body.page);
   }
   if (body.type === "block_action") {
     if (body.action_id === "view_document" && typeof body.value === "string") {
-      return renderDocumentPanel(ctx, body.value);
+      return renderDocumentPanel(ctx.kv, body.value);
     }
     if (body.action_id === "refresh_findings") {
-      return handleRefresh2(ctx, collections);
+      return handleRefresh({
+        ctx,
+        collections,
+        evaluator: inProcessEvaluator,
+        suppressionFilter,
+        tuning: adminViewTuning
+      });
     }
     if (body.action_id.startsWith("filter:")) {
-      return renderFindingsPage(ctx);
+      return renderFindingsPage(ctx.kv, adminViewTuning);
     }
-    return notFound2(body.action_id);
+    return notFound(body.action_id);
   }
   if (body.type === "form_submit") {
     if (body.action_id === "view_document") {
       const picked = body.values["route_picker"];
       if (typeof picked === "string" && picked.length > 0) {
-        return renderDocumentPanel(ctx, picked);
+        return renderDocumentPanel(ctx.kv, picked);
       }
     }
-    return renderFindingsPage(ctx);
+    return renderFindingsPage(ctx.kv, adminViewTuning);
   }
-  return renderFindingsPage(ctx);
+  return renderFindingsPage(ctx.kv, adminViewTuning);
 }
 async function handlePageLoad(ctx, page) {
   const normalized = page.startsWith("/") ? page.slice(1) : page;
   if (normalized === "" || normalized === "findings") {
-    return renderFindingsPage(ctx);
+    return renderFindingsPage(ctx.kv, adminViewTuning);
   }
   if (normalized === "widget:aexeo-score") {
-    return renderScoreWidget(ctx);
+    return renderScoreWidget(ctx.kv, adminViewTuning);
   }
   if (normalized === "document") {
-    return renderDocumentPanel(ctx);
-  }
-  return notFound2(page);
-}
-async function handleRefresh2(ctx, collections) {
-  let summary;
-  try {
-    summary = await evaluateAndPersistAll(ctx, {
-      evaluator: inProcessEvaluator,
-      collections
-    });
-  } catch (err) {
-    const detail = err instanceof Error ? err.message : String(err);
-    return {
-      blocks: [
-        { type: "header", text: "SEO findings" },
-        {
-          type: "banner",
-          title: `Refresh failed: ${detail}`,
-          variant: "error"
-        }
-      ],
-      toast: { message: `Refresh failed: ${detail}`, type: "error" }
-    };
-  }
-  const refreshed = await renderFindingsPage(ctx);
-  const toastMessage = summary.errors.length === 0 ? `Refreshed ${summary.routesUpdated} routes (${summary.totalFindings} findings across ${summary.documentsScanned} documents)` : `Refresh completed with ${summary.errors.length} errors \u2014 see banner`;
-  if (summary.errors.length > 0) {
-    refreshed.blocks.unshift({
-      type: "banner",
-      title: `Refresh issues: ${summary.errors.join(" \u2022 ")}`,
-      variant: "alert"
-    });
-  }
-  return {
-    ...refreshed,
-    toast: {
-      message: toastMessage,
-      type: summary.errors.length === 0 ? "success" : "info"
-    }
-  };
-}
-async function readAllFindings(ctx) {
-  const entries = await ctx.kv.list(
-    "findings:"
-  );
-  const out = [];
-  for (const entry of entries) {
-    if (entry.value === null) continue;
-    const route = entry.key.replace(/^findings:/, "");
-    for (const finding of entry.value.findings) {
-      out.push({ ...finding, document_route: route });
-    }
-  }
-  return out;
-}
-function severityFirst(a, b) {
-  const rank = (severity) => severity === "error" ? 0 : 1;
-  const diff = rank(a.severity) - rank(b.severity);
-  if (diff !== 0) return diff;
-  return a.rule_id.localeCompare(b.rule_id);
-}
-function uniqueRoutes(rows) {
-  const set = /* @__PURE__ */ new Set();
-  for (const row of rows) set.add(row.document_route);
-  return [...set].sort();
-}
-async function renderFindingsPage(ctx) {
-  const findings = await readAllFindings(ctx);
-  const errors = findings.filter((f) => f.severity === "error");
-  const warnings = findings.filter((f) => f.severity === "warning");
-  const sorted = [...findings].sort(severityFirst);
-  const routes = uniqueRoutes(findings);
-  const blocks = [
-    { type: "header", text: "SEO findings" },
-    {
-      type: "context",
-      text: findings.length === 0 ? "No findings yet \u2014 click Refresh to evaluate the site." : `${findings.length} findings across ${routes.length} routes \u2014 ${errors.length} errors, ${warnings.length} warnings.`
-    },
-    { type: "divider" },
-    {
-      type: "actions",
-      elements: [
-        {
-          type: "button",
-          label: "Refresh",
-          action_id: "refresh_findings",
-          style: "primary"
-        },
-        { type: "button", label: "All", action_id: "filter:all" },
-        { type: "button", label: "Errors only", action_id: "filter:errors" },
-        {
-          type: "button",
-          label: "Warnings only",
-          action_id: "filter:warnings"
-        }
-      ]
-    },
-    sorted.length === 0 ? {
-      type: "context",
-      text: "Once a Refresh runs, findings will list here."
-    } : findingsTable(sorted)
-  ];
-  if (routes.length > 0) {
-    blocks.push({
-      type: "form",
-      fields: [
-        {
-          type: "select",
-          action_id: "route_picker",
-          label: "Document to inspect",
-          options: routes.map((route) => ({ label: route, value: route }))
-        }
-      ],
-      submit: { label: "View document SEO", action_id: "view_document" }
-    });
-  }
-  return { blocks };
-}
-function findingsTable(rows) {
-  return {
-    type: "table",
-    columns: [
-      { key: "route", label: "Route" },
-      { key: "rule", label: "Rule", format: "code" },
-      { key: "severity", label: "Severity", format: "badge" },
-      { key: "message", label: "Message" }
-    ],
-    rows: rows.map((row) => ({
-      route: row.document_route,
-      rule: row.rule_id,
-      severity: row.severity,
-      message: row.message
-    }))
-  };
-}
-async function renderScoreWidget(ctx) {
-  const documents = await readAllDocuments(ctx.kv);
-  if (documents.length === 0) {
-    return {
-      blocks: [
-        { type: "header", text: "SEO score" },
-        {
-          type: "context",
-          text: "No documents indexed \u2014 click Refresh on the Aexeo findings page."
-        }
-      ]
-    };
-  }
-  const facts = await readStoredFacts(ctx.kv);
-  const score = await scoreLocally(documents, facts);
-  const truthLabel = formatTruthLabel(score);
-  const blocks = [
-    {
-      type: "stats",
-      items: [
-        { label: "Overall", value: `${score.overall_score}` },
-        { label: "Citation", value: `${score.citation_readiness_score}` },
-        { label: truthLabel, value: `${score.truth_consistency_score}` },
-        { label: "Answers", value: `${score.answer_pack_score}` }
-      ]
-    }
-  ];
-  if (score.overall_score < 60) {
-    blocks.unshift({
-      type: "banner",
-      title: `Site score is ${score.overall_score} \u2014 below the 60 quality threshold`,
-      variant: "alert"
-    });
-  }
-  if (score.blockers.length > 0) {
-    blocks.push({ type: "context", text: topBlockersLine(score) });
+    return renderDocumentPanel(ctx.kv);
   }
-  return { blocks };
+  return notFound(page);
 }
 async function scoreLocally(documents, manifest = null) {
   const manifestJson = manifest === null ? null : JSON.stringify(manifest);
@@ -1631,63 +1894,6 @@ function formatTruthLabel(score) {
       return "Truth";
   }
 }
-function topBlockersLine(score) {
-  const top = score.blockers.slice(0, 3).map((b) => b.message);
-  if (top.length === 0) return "No blockers identified.";
-  return `Top blockers: ${top.join(" \u2022 ")}`;
-}
-async function renderDocumentPanel(ctx, route) {
-  if (route === void 0) {
-    return {
-      blocks: [
-        { type: "header", text: "Document SEO" },
-        {
-          type: "context",
-          text: "Pick a document from the SEO findings list to see its rule findings here."
-        }
-      ]
-    };
-  }
-  const findings = await readFindings(ctx.kv, route);
-  const errors = findings.filter((f) => f.severity === "error");
-  const warnings = findings.filter((f) => f.severity === "warning");
-  const sorted = [...findings].sort(severityFirst);
-  return {
-    blocks: [
-      { type: "header", text: `Document SEO \u2014 ${route}` },
-      {
-        type: "context",
-        text: findings.length === 0 ? `No findings for ${route} \u2014 the document is currently clean.` : `${findings.length} findings \u2014 ${errors.length} errors, ${warnings.length} warnings.`
-      },
-      ...findings.length === 0 ? [] : [{ type: "divider" }, documentFindingsTable(sorted)]
-    ]
-  };
-}
-function documentFindingsTable(findings) {
-  return {
-    type: "table",
-    columns: [
-      { key: "rule", label: "Rule", format: "code" },
-      { key: "severity", label: "Severity", format: "badge" },
-      { key: "message", label: "Message" },
-      { key: "block", label: "Block", format: "code" }
-    ],
-    rows: findings.map((finding) => ({
-      rule: finding.rule_id,
-      severity: finding.severity,
-      message: finding.message,
-      block: `${finding.path}:${finding.line}`
-    }))
-  };
-}
-function notFound2(page) {
-  return {
-    blocks: [
-      { type: "header", text: "Not found" },
-      { type: "context", text: `unknown page: ${page}` }
-    ]
-  };
-}
 export {
   createPlugin,
   configured_default as default