@aeptus/aexeo-emdash 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -6,6 +6,38 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [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 +100,7 @@ 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.1.2...HEAD
+[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/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":"AA6EA,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAmD3E;AAID,eAAe,YAAY,CAAC"}

package/dist/configured.js

@@ -357,24 +357,33 @@ 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)
+      }
     },
     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 +394,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 +404,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 +435,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/index.d.ts

@@ -18,6 +18,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;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;IAClC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,0BAA0B,CAsC5B"}

package/dist/index.js

@@ -57,17 +57,27 @@ function seogeoPlugin(options = {}) {
     // time — must match the package.json `exports["./configured"]`
     // entry.
     entrypoint: "@aeptus/aexeo-emdash/configured",
-    options: { ...options },
+    // 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeptus/aexeo-emdash",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Aexeo seogeo SEO/GEO content evaluator as an emdash plugin",
   "license": "MIT",
   "author": "Aexeo",