@aeptus/aexeo-emdash 0.8.1 → 0.8.3

package/CHANGELOG.md

@@ -6,6 +6,95 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.3] - 2026-05-04
+
+Picks up the upstream aexeo-core 0.0.9 improvements that address
+the two open quality items Aeptus flagged after the 0.8.1 + CLI
+0.0.8 rollout.
+
+### Changed (engine via bridge)
+
+- **Truth-manifest generator no longer picks listing-page or
+  404 titles as the organization/product name.** Aeptus's
+  facts.json was being generated with `organization.name = "Blog"`
+  and `product.name = "Page not found"` because the listing page's
+  title outvoted the homepage and the 404 page's title leaked into
+  the candidate corpus. Three engine fixes ship in this release:
+  (a) the generic-label blocklist now covers blog, posts,
+  articles, authors, tags, categories, search, archive, page not
+  found, 404, error, oops, and pure-numeric labels;
+  (b) 404 / error pages are detected by title/h1 patterns and
+  excluded from the candidate corpus entirely;
+  (c) the homepage signal wins over any subpage signal regardless
+  of count when present.
+
+  This is a generation-quality improvement, not a wire-format
+  change — existing stored manifests are unaffected. Hosts who
+  re-run `intelligence facts generate` will get a cleaner draft.
+
+- **GEO009 ("page facts misalign across title/H1/OG/schema")
+  now uses the same identity-extraction logic as the
+  `intelligence identity` diagnostic.** Previously the rule read
+  every JSON-LD `name` field (including BreadcrumbList items and
+  ItemList children), so it fired on listing/author/localized
+  routes where breadcrumb crumbs leaked in. The diagnostic
+  already restricted to top-level identity-bearing schema; the
+  rule and the diagnostic now share that filter. Aeptus's
+  ~44 GEO009 warnings on listing/author/localized routes should
+  drop after re-running the audit.
+
+### Notes for hosts upgrading from 0.8.x
+
+- No code changes required — pure engine-side improvements.
+- Re-run `intelligence facts generate` if you generated your
+  manifest with v0.0.7 or earlier of the CLI; the new generator
+  output is materially better.
+- Re-run the audit; expect GEO009 counts to drop on listing
+  pages without any host-side change.
+
+## [0.8.2] - 2026-05-04
+
+Fix for the residual entity-presence trim() crash that 0.8.1
+didn't solve.
+
+### Fixed
+
+- **`/facts` and `/presence` routes were double-wrapping their
+  return values.** Both handlers returned `{ data: ... }` payloads,
+  but emdash's route registry already wraps a handler's return as
+  `{ data: <result> }` at the wire boundary. The result was
+  `{ data: { data: ... } }` on the wire. The React caller's
+  single-unwrap (`body.data`) surfaced `{ data: ... }` to the
+  consumer where the actual payload was expected — so
+  `(res as ManifestData).manifest` came back as `undefined`,
+  `JSON.stringify(undefined)` returned the literal `undefined`,
+  `setDraft(undefined)` set the textarea draft to undefined, and
+  the next render crashed on `draft.trim()`.
+
+  Fixed by changing both route handlers to return raw payloads
+  (matching the `/data` and `/refresh` route convention that has
+  always worked correctly). Errors are now signaled by throwing
+  `PluginRouteError` from the `emdash` package — the registry
+  treats thrown PluginRouteErrors as structured failures and
+  routes them through the host's standard error path. Returned
+  `{ error: ... }` objects (the previous pattern) flowed through
+  the success path and silently masqueraded as data.
+
+### Notes for hosts upgrading from 0.8.x
+
+- No code changes required.
+- The wire format of the `/facts` and `/presence` route responses
+  changes: where they previously returned
+  `{ data: { data: <payload> } }`, they now return
+  `{ data: <payload> }`. Anyone calling these routes directly
+  (outside the bundled React admin) needs to drop one unwrap.
+  The bundled admin is updated in lockstep so editors see no
+  behavioral difference beyond the bug being fixed.
+- Error responses for these routes now come back through the
+  standard `PluginRouteError` envelope (HTTP 4xx with
+  `{ error: { code, message } }`) instead of being silently
+  embedded in success responses.
+
 ## [0.8.1] - 2026-05-03
 
 Fix for the entity-presence diagnostic shipped in 0.8.0.
@@ -519,7 +608,9 @@ 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.8.1...HEAD
+[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.3...HEAD
+[0.8.3]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.2...aexeo-emdash-v0.8.3
+[0.8.2]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.1...aexeo-emdash-v0.8.2
 [0.8.1]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.0...aexeo-emdash-v0.8.1
 [0.8.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.7.0...aexeo-emdash-v0.8.0
 [0.7.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.6.0...aexeo-emdash-v0.7.0

package/dist/configured.js

@@ -469,8 +469,8 @@ async function handleDataRoute(ctx, options) {
     });
     await persistManifestStateFindings(ctx);
   }
-  const payload = await buildFindingsPayload(ctx);
-  return { payload, summary };
+  const payload2 = await buildFindingsPayload(ctx);
+  return { payload: payload2, summary };
 }
 async function buildFindingsPayload(ctx) {
   const stored = await readAllStoredDocuments(ctx.kv);
@@ -649,6 +649,7 @@ function buildPublishedUrl(meta, route, siteUrl) {
 }
 
 // src/facts-route.ts
+import { PluginRouteError } from "emdash";
 async function handleFactsRoute(ctx) {
   const body = ctx.input ?? {};
   switch (body.kind) {
@@ -661,47 +662,34 @@ async function handleFactsRoute(ctx) {
     case "save":
       return await handleSave(ctx, body);
     default:
-      return {
-        error: {
-          code: "unknown_kind",
-          message: `unknown facts route kind: ${String(body.kind)}`
-        }
-      };
+      throw PluginRouteError.badRequest(
+        `unknown facts route kind: ${String(body.kind)}`
+      );
   }
 }
 async function handleData(ctx) {
   const manifest = await readStoredFacts(ctx.kv);
   return {
-    data: {
-      manifest,
-      // The presence flag lets the React component branch on
-      // "show authoring CTA" vs "show 'manifest stored' state" without
-      // having to introspect the manifest shape.
-      present: manifest !== null
-    }
+    manifest,
+    // The presence flag lets the React component branch on
+    // "show authoring CTA" vs "show 'manifest stored' state" without
+    // having to introspect the manifest shape.
+    present: manifest !== null
   };
 }
 async function handlePrompt(ctx) {
   const documents = await readAllDocuments(ctx.kv);
   if (documents.length === 0) {
-    return {
-      error: {
-        code: "no_documents",
-        message: "no documents indexed yet \u2014 click Refresh on the Findings page first, then come back to author the manifest"
-      }
-    };
+    throw PluginRouteError.badRequest(
+      "no documents indexed yet \u2014 click Refresh on the Findings page first, then come back to author the manifest"
+    );
   }
   const prompt = await generateFactsPrompt2(JSON.stringify(documents));
-  return { data: { prompt } };
+  return { prompt };
 }
 async function handleValidate(ctx, body) {
   if (typeof body.manifest_json !== "string" || body.manifest_json.length === 0) {
-    return {
-      error: {
-        code: "missing_manifest",
-        message: "manifest_json field is required"
-      }
-    };
+    throw PluginRouteError.badRequest("manifest_json field is required");
   }
   const documents = await readAllDocuments(ctx.kv);
   try {
@@ -709,24 +697,16 @@ async function handleValidate(ctx, body) {
       body.manifest_json,
       JSON.stringify(documents)
     );
-    return { data: JSON.parse(raw) };
+    return JSON.parse(raw);
   } catch (error) {
-    return {
-      error: {
-        code: "validate_failed",
-        message: error instanceof Error ? error.message : String(error)
-      }
-    };
+    throw PluginRouteError.badRequest(
+      error instanceof Error ? error.message : String(error)
+    );
   }
 }
 async function handleSave(ctx, body) {
   if (typeof body.manifest_json !== "string" || body.manifest_json.length === 0) {
-    return {
-      error: {
-        code: "missing_manifest",
-        message: "manifest_json field is required"
-      }
-    };
+    throw PluginRouteError.badRequest("manifest_json field is required");
   }
   const documents = await readAllDocuments(ctx.kv);
   let validation;
@@ -738,37 +718,31 @@ async function handleSave(ctx, body) {
     const parsed2 = JSON.parse(raw);
     validation = parsed2.validation;
   } catch (error) {
-    return {
-      error: {
-        code: "validate_failed",
-        message: error instanceof Error ? error.message : String(error)
-      }
-    };
+    throw PluginRouteError.badRequest(
+      error instanceof Error ? error.message : String(error)
+    );
   }
   if (!validation.valid || validation.errors.length > 0) {
-    return {
-      error: {
-        code: "validation_failed",
-        message: `manifest does not pass shape validation: ${validation.errors.slice(0, 3).join("; ")}`
-      }
-    };
+    throw PluginRouteError.badRequest(
+      `manifest does not pass shape validation: ${validation.errors.slice(0, 3).join("; ")}`
+    );
   }
   let parsed;
   try {
     parsed = JSON.parse(body.manifest_json);
   } catch (error) {
-    return {
-      error: {
-        code: "parse_failed",
-        message: error instanceof Error ? error.message : String(error)
-      }
-    };
+    throw PluginRouteError.badRequest(
+      error instanceof Error ? error.message : String(error)
+    );
   }
   await ctx.kv.set(FACTS_KEY, parsed);
   await persistManifestStateFindings(ctx);
-  return { data: { saved: true } };
+  return { saved: true };
 }
 
+// src/presence-route.ts
+import { PluginRouteError as PluginRouteError2 } from "emdash";
+
 // src/presence-check.ts
 var FETCH_TIMEOUT_MS = 5e3;
 var USER_AGENT = "aexeo-emdash-plugin/0.8 (+https://github.com/schiste/Aexeo; entity-presence diagnostic)";
@@ -1073,58 +1047,53 @@ async function handlePresenceRoute(ctx) {
     case "refresh":
       return await handleRefresh(ctx);
     default:
-      return {
-        error: {
-          code: "unknown_kind",
-          message: `unknown presence route kind: ${String(body.kind)}`
-        }
-      };
+      throw PluginRouteError2.badRequest(
+        `unknown presence route kind: ${String(body.kind)}`
+      );
   }
 }
 async function handleData2(ctx) {
   const manifest = await readStoredFacts(ctx.kv);
   if (manifest === null) {
-    return wireResponse("no_manifest", [], null, null);
+    return payload("no_manifest", [], null, null);
   }
   const entity = entityFromManifest(manifest);
   if (entity === null) {
-    return wireResponse("no_organization", [], null, null);
+    return payload("no_organization", [], null, null);
   }
   const cached = await ctx.kv.get(PRESENCE_KEY);
   if (!cached) {
-    return wireResponse("empty", [], null, entity.name);
+    return payload("empty", [], null, entity.name);
   }
   if (cached.entityName !== entity.name) {
-    return wireResponse("empty", [], null, entity.name);
+    return payload("empty", [], null, entity.name);
   }
   const ageMs = ageMillis(cached.generatedAt);
   const state = ageMs !== null && ageMs > CACHE_TTL_MS ? "stale" : "fresh";
-  return wireResponse(state, cached.results, cached.generatedAt, entity.name);
+  return payload(state, cached.results, cached.generatedAt, entity.name);
 }
 async function handleRefresh(ctx) {
   const manifest = await readStoredFacts(ctx.kv);
   if (manifest === null) {
-    return wireResponse("no_manifest", [], null, null);
+    return payload("no_manifest", [], null, null);
   }
   const entity = entityFromManifest(manifest);
   if (entity === null) {
-    return wireResponse("no_organization", [], null, null);
+    return payload("no_organization", [], null, null);
   }
   const results = await checkAllSources(entity);
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const payload = {
+  const cachePayload = {
     results,
     generatedAt,
     entityName: entity.name
   };
-  await ctx.kv.set(PRESENCE_KEY, payload);
-  return wireResponse("fresh", results, generatedAt, entity.name);
+  await ctx.kv.set(PRESENCE_KEY, cachePayload);
+  return payload("fresh", results, generatedAt, entity.name);
 }
-function wireResponse(state, results, generatedAt, entityName) {
+function payload(state, results, generatedAt, entityName) {
   const ageMinutes = generatedAt === null ? null : Math.max(0, Math.floor((ageMillis(generatedAt) ?? 0) / 6e4));
-  return {
-    data: { state, results, generatedAt, entityName, ageMinutes }
-  };
+  return { state, results, generatedAt, entityName, ageMinutes };
 }
 function ageMillis(iso) {
   const t = Date.parse(iso);
@@ -1191,7 +1160,7 @@ function globToMatcher(pattern) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.1";
+var PACKAGE_VERSION = "0.8.3";
 
 // src/configured.ts
 import { definePlugin } from "emdash";

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

@@ -1 +1 @@
-{"version":3,"file":"facts-route.d.ts","sourceRoot":"","sources":["../src/facts-route.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C,UAAU,YAAa,SAAQ,UAAU;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB1E"}
+{"version":3,"file":"facts-route.d.ts","sourceRoot":"","sources":["../src/facts-route.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C,UAAU,YAAa,SAAQ,UAAU;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB1E"}

package/dist/index.js

@@ -23,7 +23,7 @@ function buildAllowedHosts(evaluatorHost) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.1";
+var PACKAGE_VERSION = "0.8.3";
 
 // src/sandbox.ts
 function aexeoPluginSandboxed(options = {}) {

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

@@ -1 +1 @@
-{"version":3,"file":"presence-route.d.ts","sourceRoot":"","sources":["../src/presence-route.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuC9C,UAAU,YAAa,SAAQ,UAAU;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"presence-route.d.ts","sourceRoot":"","sources":["../src/presence-route.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0C9C,UAAU,YAAa,SAAQ,UAAU;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "0.8.1";
+export declare const PACKAGE_VERSION = "0.8.3";
 //# sourceMappingURL=version.d.ts.map

package/package.json

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