@aeptus/aexeo-emdash 0.8.17 → 0.8.18

package/CHANGELOG.md

@@ -6,6 +6,37 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.18] - 2026-09-27
+
+Updates the EmDash integration to the current plugin and content APIs.
+
+**Compatibility target:** EmDash `>=0.41.0 <0.42.0`.
+
+### Fixed
+
+- **Sandbox access declaration:** replace obsolete capability strings with
+  `content:read` and conditional `network:request`, scoped to the configured
+  evaluator host. Remove unused schema, artifact, KV, and IndexNow host grants.
+- **Typed `blocks` content:** distinguish EmDash block compositions from
+  Portable Text and adapt their editorial strings into the evaluator's text
+  format instead of discarding them.
+- **Routes and translations:** use EmDash's `getPublicUrl()` and
+  `getTranslations()` APIs for collection patterns, locale paths, trailing
+  slash policy, and hreflang alternates. Keep draft and unroutable entries
+  under stable collection/ID keys, and link only to URLs the host resolves.
+- **Sandbox save evaluation:** `content:afterSave` now persists and evaluates
+  the saved item through the configured sidecar, matching configured mode.
+- **Route migrations:** remove obsolete document and finding entries when a
+  document's resolved route changes or a successful refresh no longer finds
+  an entry in the selected collections.
+
+### Changed
+
+- Bump the EmDash peer and development ranges to `0.41.x`; update the README
+  and install guide to name the supported range and sandbox save behavior.
+- Add Vitest coverage using EmDash's official plugin runtime test host for
+  sandbox hooks, blocks extraction, resolved URLs, and translation alternates.
+
 ## [0.8.17] - 2026-05-29
 
 Hotfix release. Closes the production admin-route regression

package/INSTALL.md

@@ -31,7 +31,8 @@ when it's actually needed.
   (`@astrojs/cloudflare` + `@emdash-cms/cloudflare`'s `sandbox()`
   runner is fine — sandboxed plugins use Worker Loader, configured
   plugins don't, but both adapters import cleanly).
-- emdash 0.7.0 or later as a peer dependency.
+- EmDash `>=0.41.0 <0.42.0` as a peer dependency. The integration
+  coverage targets `0.41.0` with EmDash's official plugin test host.
 
 ### Install
 
@@ -106,9 +107,8 @@ no sidecar to deploy.
    — toast says "Refreshed N routes (M findings across K documents)"
    and the table populates.
 
-4. Save a document: the `content:afterSave` hook auto-evaluates that
-   one document; refresh the findings page and that route's findings
-   are updated. (The dashboard widget also picks up the new score.)
+4. Save a document: `content:afterSave` evaluates that document. Reload
+   the findings page to see the updated row and dashboard score.
 
 ### Production deploy
 
@@ -171,8 +171,8 @@ Pre-flight before bumping:
 
 1. Look up the plugin version's tested emdash range in our
    [CHANGELOG](./CHANGELOG.md). The latest plugin version's
-   `Compatibility` line says e.g. "tested against emdash 0.7.0
-   through 0.8.0." If the emdash version you want is **inside that
+   `Compatibility` line names the supported EmDash range and test-host
+   target. If the EmDash version you want is **inside that
    range**, the bump is safe. If it's **above the range**, treat it
    as untested.
 2. If untested, scan the emdash release notes for breaking changes
@@ -181,7 +181,7 @@ Pre-flight before bumping:
    - Hook signatures (`content:afterSave`, etc.)
    - Block Kit element schemas (banner variants, button styles,
      table column formats)
-   - Capability validation strings (`read:content`, `network:fetch`)
+   - Capability names (`content:read`, `network:request`)
    - The `definePlugin` API
    - The `createPlugin` / configured-plugin descriptor contract
    If any of those changed, expect to bump the plugin too.
@@ -240,9 +240,8 @@ Trade-offs vs. configured mode:
   prevents the plugin from ever reading host state directly.
 - **Con**: separate sidecar Worker to deploy and maintain; an
   EVAL_TOKEN to rotate; a Setup admin page to configure. The
-  `content:afterSave` hook is also non-functional in emdash 0.7.x's
-  sandbox (post-response bridge invalidation — known upstream issue);
-  evaluation is manual-Refresh-only.
+  `content:afterSave` hook evaluates through the sidecar after you save
+  its URL and token on the Setup page. Refresh still runs a full-site sweep.
 
 ```js
 // astro.config.mjs (sandboxed mode)

package/README.md

@@ -47,12 +47,15 @@ troubleshooting list, see [INSTALL.md](./INSTALL.md).
   answer-pack, external-trust dimensions). Banner appears below 60.
 - **Refresh button**: re-evaluate every document in the configured
   collections (`posts`, `pages` by default).
-- **Auto-evaluate on save**: emdash's `content:afterSave` hook fires,
-  re-evaluates the saved document, updates the findings table.
+- **Auto-evaluate on save**: EmDash's `content:afterSave` hook evaluates
+  the saved document and updates its findings. Sandboxed installs need a
+  configured evaluator sidecar; configured installs run evaluation in-process.
 
 ## Compatibility
 
-- emdash `>= 0.7.0` (peer dep)
+- EmDash `>= 0.41.0 < 0.42.0` (peer dependency; current supported range)
+- Runtime integration coverage targets EmDash `0.41.0` via the official
+  `@emdash-cms/plugin-test` host.
 - Cloudflare Workers via `@astrojs/cloudflare`. The plugin uses
   Cloudflare-specific APIs and silently no-ops on the Node adapter.
 - WASM eval ships with the package; the consumer's Vite/Wrangler

package/dist/adapter.d.ts

@@ -5,6 +5,7 @@ export interface EmdashContentItem {
     slug: string | null;
     status: string;
     locale: string | null;
+    translationGroup?: string | null;
     data: Record<string, unknown>;
     seo?: {
         title?: string | null;
@@ -18,11 +19,41 @@ export interface EmdashContentMeta {
     slug: string | null;
     status: string;
     title: string;
+    /** Exact URL returned by EmDash, or null when this entry has no public route. */
+    publicUrl: string | null;
+}
+export interface ContentUrlApi {
+    getPublicUrl(collection: string, id: string): Promise<string | null>;
+    getTranslations(collection: string, id: string): Promise<{
+        translationGroup: string;
+        translations: Array<{
+            id: string;
+            locale: string | null;
+            slug: string | null;
+            status: string;
+            updatedAt: string;
+        }>;
+    }>;
 }
 export interface AdaptedContent {
     document: EmdashDocument;
     meta: EmdashContentMeta;
 }
+/**
+ * Adapt a stored content row using EmDash's route resolver. The host API
+ * accounts for collection URL patterns, locale prefixes, and slash policy;
+ * slug-derived paths are not equivalent to the site's actual public URLs.
+ */
+export declare function adaptContentItemWithContext(content: EmdashContentItem, contentApi: ContentUrlApi, defaultLocale?: string): Promise<AdaptedContent>;
+/**
+ * Synchronous adapter for callers that do not have a host content API.
+ * It deliberately uses a stable identity route; callers should use
+ * adaptContentItemWithContext whenever EmDash can resolve the public URL.
+ */
 export declare function contentItemToEmdashDocument(content: EmdashContentItem): EmdashDocument;
-export declare function adaptContentItem(content: EmdashContentItem): AdaptedContent;
+export declare function adaptContentItem(content: EmdashContentItem, options?: {
+    route?: string;
+    publicUrl?: string | null;
+    defaultLocale?: string;
+}): 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;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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAEpE,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,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,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,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;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrE,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;QACT,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,KAAK,CAAC;YAClB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;YACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YACpB,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,aAAa,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,CA2CzB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAEhB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,cAAc,CAgChB"}

package/dist/configured.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0HrD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CA4H3E;AAID,eAAe,YAAY,CAAC"}
+{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0HrD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CA0H3E;AAID,eAAe,YAAY,CAAC"}

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,152 @@ 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"])));
+    }
+  }
+  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;
   }
-  const first = value[0];
-  return typeof first === "object" && first !== null && "_type" in first && typeof first._type === "string";
+  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
 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 +254,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 +310,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,25 +381,8 @@ 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);
-      continue;
-    }
-    if ("route" in value) {
-      const document = value;
-      out.push({
-        document,
-        meta: {
-          id: document.route,
-          collection: "",
-          slug: null,
-          status: "",
-          title: document.title ?? ""
-        }
-      });
-    }
+    const stored = toStoredDocument(entry.value);
+    if (stored !== null) out.push(stored);
   }
   return out;
 }
@@ -559,7 +724,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 +734,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 +860,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";
@@ -1215,7 +1373,7 @@ function globToMatcher(pattern) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.17";
+var PACKAGE_VERSION = "0.8.18";
 
 // src/configured.ts
 import { definePlugin } from "emdash";
@@ -1284,7 +1442,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

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

@@ -1 +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;AAQrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C,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,cAAc,EAAE,cAAc,EAAE,CAAC;IAIjC,gBAAgB,EAAE,OAAO,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,YAAY,EAAE,KAAK,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;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;IAM1B,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,UAAU,CAAC;CAC1C;AAED,UAAU,gBAAgB;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,WAAW,CAAC;IAIvB,OAAO,EAAE,OAAO,CAAC;IAIjB,iBAAiB,CAAC,EAAE,OAAO,mBAAmB,EAAE,iBAAiB,CAAC;CACnE;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,CAmBD;AA6ID,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"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;AAQrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1C,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,cAAc,EAAE,cAAc,EAAE,CAAC;IAIjC,gBAAgB,EAAE,OAAO,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,YAAY,EAAE,KAAK,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;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;IAM1B,MAAM,CAAC,EAAE,OAAO,YAAY,EAAE,UAAU,CAAC;CAC1C;AAED,UAAU,gBAAgB;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,WAAW,CAAC;IAIvB,OAAO,EAAE,OAAO,CAAC;IAIjB,iBAAiB,CAAC,EAAE,OAAO,mBAAmB,EAAE,iBAAiB,CAAC;CACnE;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,CAmBD;AA4ID,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAYtB,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,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,0BAA0B,CAqE5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAYtB,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,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,0BAA0B,CAiE5B"}