@aeptus/aexeo-emdash 0.5.0 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,188 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-05-03
+
+Layer-4 entity-presence diagnostic. The `/entity-legitimacy`
+admin page now queries five free public APIs against the
+configured organization in the truth manifest and surfaces what
+the open web actually shows.
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Added
+
+- **Public web presence diagnostic** on `/entity-legitimacy`,
+  below the truth-manifest authoring section. Five sources, one
+  card each, one Refresh button:
+  - **Wikipedia** (OpenSearch)
+  - **Wikidata** (`wbsearchentities`)
+  - **GitHub** (`/users/<handle>`)
+  - **Domain registration** (RDAP via the `rdap.org` redirector)
+  - **Common Crawl** (CDX index latest available)
+
+  Each card shows one of four states: *found* (with deep-link),
+  *no record*, *couldn't reach* (network/timeout/rate-limit),
+  *skipped* (preconditions missing). No scoring — Aexeo surfaces
+  this layer, it does not grade it. The "Open ↗" link on each
+  *found* row deep-links to the source's record so editors can
+  verify directly.
+- **`POST .../plugins/aexeo-emdash/presence`** route with `kind:
+  "data"` (cached read) and `kind: "refresh"` (re-query and
+  persist) operations. Cached for 24h in `presence:current`; the
+  cache is invalidated when the manifest's organization name
+  changes (so stale results against a different entity never show).
+- **`TruthEntity` and `TruthManifest` type exports** — minimal
+  TS projections of the Rust truth-manifest shape, sufficient for
+  the fields the plugin reads on the TS side.
+
+### Notes on rate limits
+
+The five APIs are all free and unauthenticated. The 24h cache
+is the rate-limit backstop:
+- GitHub's 60/hr unauth cap is the binding constraint and stays
+  comfortably under the limit even with liberal manual refreshing.
+- Wikipedia, Wikidata, and Common Crawl have no published cap;
+  the plugin sends a polite `User-Agent` identifying itself.
+- RDAP via `rdap.org` is a community redirector with no published
+  cap.
+
+If a fetch times out (>5s) or returns 429/5xx, the corresponding
+source card shows "couldn't reach" with the underlying error;
+hitting Refresh later retries.
+
+### Notes for hosts upgrading from 0.7.x
+
+- No code changes required. The configured factory is unchanged
+  and the new route is registered automatically.
+- Editors who haven't authored a truth manifest yet will see the
+  "Author the truth manifest first" CTA on `/entity-legitimacy`
+  — this is the same page where they author the manifest, so the
+  CTA composes cleanly.
+- The presence diagnostic doesn't run on its own. Editors must
+  click Refresh once after authoring (or updating) the manifest
+  to populate the cache.
+
+## [0.7.0] - 2026-05-03
+
+Restructures the admin sidebar around the four-layer GEO model
+(retrievability, citability, absorbability, entity legitimacy) from
+the May 2026 research synthesis. Each pillar is its own admin page,
+each finding carries its rule's layer assignment, and the
+entity-legitimacy pillar folds in the truth-manifest authoring UI.
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Added
+
+- **Four pillar admin pages**: `/retrievability`, `/citability`,
+  `/absorbability`, `/entity-legitimacy`. Each filters findings to
+  rules whose primary layer matches; cross-cutting rules surface
+  their secondary layers as chips on the row ("this rule also
+  affects citability").
+- **`layerBreakdown` field** on the `FindingsPayload` wire shape.
+  One entry per layer with totals, errors, and warnings; primary
+  layer only, so the sum equals `totals.findings`. Powers the
+  pillar header counts and a future dashboard widget badge.
+- **`layers` field on each `Finding`**, populated by the bridge
+  during `evaluateDocuments`. Optional in the type so legacy KV
+  entries written before the enrichment landed still parse —
+  legacy rows fall back to `citability` (the most common layer)
+  until the next refresh repopulates them.
+- **Type exports**: `Layer`, `RuleLayers`, `LAYERS_ORDERED`,
+  `layerHumanLabel`, `layerOneLineDescription` from the package
+  root for hosts that want to reuse the framework.
+
+### Changed
+
+- **`/facts` is now an alias** for `/entity-legitimacy`. The
+  truth-manifest authoring UI is unchanged but it lives inside the
+  entity-legitimacy pillar page (composed alongside FACTS00x
+  findings and a placeholder for the layer-4 presence diagnostic
+  shipping in 0.8.0). Old bookmarks to `/facts` keep working.
+- **Sidebar order changed**: pillar entries first, then `/document`
+  (cross-layer per-document panel), then `/findings` (the existing
+  cross-pillar flat-view, kept for "show me everything" triage).
+  Editors who had the old "SEO findings / Document SEO / Truth
+  manifest" layout in muscle memory will need to re-orient.
+- **WASM bridge enriches each finding** with its layer assignment
+  before returning JSON. The Rust engine is the canonical layer
+  authority; the plugin doesn't maintain a parallel mapping.
+
+### Notes for hosts upgrading from 0.6.x
+
+- No code changes required for hosts using only `aexeoPlugin({ ... })`.
+  The configured factory is unchanged.
+- The four pillar pages each carry their own URL path — links to
+  `/admin/plugins/aexeo-emdash/retrievability` etc. work
+  immediately after upgrade.
+- Editors will see four new sidebar entries and one renamed entry
+  (`Truth manifest` is gone from the sidebar; its content lives at
+  `Entity legitimacy`). Worth a brief internal note to the
+  editorial team before deploying the bump.
+
+## [0.6.0] - 2026-05-03
+
+**Breaking change**: the `seogeo` → `aexeo` rename across the
+codebase reaches the published API. Hosts on 0.5.x using the
+sandboxed factory or the env-var fallback need to update their
+imports and config. The configured factory was already named
+`aexeoPlugin` in 0.5.x, so consumers using only that path are
+unaffected.
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Changed (breaking)
+
+- **Sandboxed factory rename:** `seogeoPluginSandboxed(...)` is now
+  `aexeoPluginSandboxed(...)`. Update your import:
+
+  ```ts
+  // before (0.5.x)
+  import { seogeoPluginSandboxed } from "@aeptus/aexeo-emdash";
+  // after (0.6.0)
+  import { aexeoPluginSandboxed } from "@aeptus/aexeo-emdash";
+  ```
+
+- **Sandboxed options type rename:** `SeogeoSandboxedOptions` →
+  `AexeoSandboxedOptions`. Same migration as above for any host
+  that referenced the type name explicitly.
+
+- **Env var rename:** `SEOGEO_EVALUATOR_HOST` →
+  `AEXEO_EVALUATOR_HOST`. Update any CI / Cloudflare Pages build
+  config that sets the old name. The fallback chain is unchanged
+  otherwise (factory option > env var > none).
+
+- **Plugin id rename:** the plugin's emdash id is now `aexeo-emdash`
+  (was `aexeo-seogeo`). This affects:
+  - admin URL paths: `/admin/plugins/aexeo-emdash/...` (was
+    `/admin/plugins/aexeo-seogeo/...`)
+  - any host code that referenced the plugin id explicitly (e.g.
+    in `usePluginPage(pluginId, ...)` or in plugin-bridge URLs)
+  - the React `adminEntry` URL convention is unchanged at the
+    HTTP route level (the React pages still mount under the new
+    plugin id automatically)
+
+- **Widget id rename:** `seogeo-score` → `aexeo-score`. Hosts that
+  declared this widget id explicitly in their dashboard config need
+  to update.
+
+### Notes for hosts upgrading from 0.5.x
+
+The configured factory has been `aexeoPlugin` since 0.5.0 — sites
+using only `aexeoPlugin({ ... })` need no code changes for this
+release. The breaking changes above only affect:
+
+1. Hosts using the sandboxed factory.
+2. Hosts deploying with the `SEOGEO_EVALUATOR_HOST` env var.
+3. Host-side code or workflows that hardcode the plugin id
+   (`aexeo-seogeo`) or widget id (`seogeo-score`).
+
+Migration is a sed-and-rebuild for most hosts. The rename was the
+last user-facing trace of the original `seogeo` codebase name —
+0.6.0 closes the renaming pass that started across the workspace
+in late April.
+
 ## [0.5.0] - 2026-05-01
 
 Three follow-ups from real-world adoption feedback after 0.4.0:
@@ -317,7 +499,10 @@ 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.5.0...HEAD
+[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.0...HEAD
+[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
+[0.6.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.5.0...aexeo-emdash-v0.6.0
 [0.5.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.4.0...aexeo-emdash-v0.5.0
 [0.4.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.3.0...aexeo-emdash-v0.4.0
 [0.3.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.2.0...aexeo-emdash-v0.3.0

package/dist/admin/Absorbability.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Absorbability.d.ts","sourceRoot":"","sources":["../../src/admin/Absorbability.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,wBAAgB,aAAa,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAEjD"}

package/dist/admin/Citability.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Citability.d.ts","sourceRoot":"","sources":["../../src/admin/Citability.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,wBAAgB,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAE9C"}

package/dist/admin/EntityLegitimacy.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLegitimacy.d.ts","sourceRoot":"","sources":["../../src/admin/EntityLegitimacy.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CA0BpD"}

package/dist/admin/EntityPresence.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityPresence.d.ts","sourceRoot":"","sources":["../../src/admin/EntityPresence.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAiD/B,wBAAgB,cAAc,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAqHlD"}

package/dist/admin/PillarView.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import { type Layer } from "../types.js";
+export declare function PillarView({ layer, extraSlot, }: {
+    layer: Layer;
+    extraSlot?: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=PillarView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PillarView.d.ts","sourceRoot":"","sources":["../../src/admin/PillarView.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,EAGL,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAWrB,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,GACV,EAAE;IACD,KAAK,EAAE,KAAK,CAAC;IAGb,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6MpB"}

package/dist/admin/Retrievability.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Retrievability.d.ts","sourceRoot":"","sources":["../../src/admin/Retrievability.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,wBAAgB,cAAc,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAElD"}

package/dist/admin.d.ts

@@ -1,6 +1,14 @@
+import { Absorbability } from "./admin/Absorbability.js";
+import { Citability } from "./admin/Citability.js";
+import { EntityLegitimacy } from "./admin/EntityLegitimacy.js";
 import { Facts } from "./admin/Facts.js";
 import { Findings } from "./admin/Findings.js";
+import { Retrievability } from "./admin/Retrievability.js";
 export declare const pages: {
+    "/retrievability": typeof Retrievability;
+    "/citability": typeof Citability;
+    "/absorbability": typeof Absorbability;
+    "/entity-legitimacy": typeof EntityLegitimacy;
     "/findings": typeof Findings;
     "/facts": typeof Facts;
 };

package/dist/admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,eAAO,MAAM,KAAK;;;CAMjB,CAAC"}
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,eAAO,MAAM,KAAK;;;;;;;CAajB,CAAC"}