@aeptus/aexeo-emdash 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -6,6 +6,119 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-05-01
+
+Adds upstreamed support for editor-workflow finding suppressions.
+Removes the last reason for consumer sites to maintain a local
+patch over the published plugin.
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Added
+
+- **`seogeoPlugin({ suppressions })` option.** Each rule silences
+  findings matching the route pattern (glob) AND/OR a rule-id set.
+  Applied before findings are persisted to KV — suppressed findings
+  never reach the dashboard, /findings, or the per-document panel.
+
+  ```ts
+  seogeoPlugin({
+    suppressions: [
+      { routePattern: "/privacy", ruleIds: ["RULE001"] },
+      { routePattern: "/fr-fr/**", ruleIds: ["RULE002"] },
+      { ruleIds: ["RULE999"] }, // applies to every route
+    ],
+  })
+  ```
+
+  Glob: `*` matches non-`/` chars, `**` matches across `/`, `?`
+  matches one non-`/` char. Patterns are anchored. Empty rules
+  (`{}` with neither field) are rejected at plugin construction
+  with a clear error — that's a kill-switch for all findings
+  everywhere and almost certainly an editor mistake.
+
+- **`Suppression` type** re-exported from the package root for hosts
+  that want to type their config:
+
+  ```ts
+  import type { Suppression } from "@aeptus/aexeo-emdash";
+  ```
+
+### Notes for hosts upgrading from 0.3.x
+
+- No automatic behavior change. `suppressions` defaults to undefined
+  and the filter is a no-op until the host opts in.
+- Suppressions are plugin-only by design. The CLI `check` continues
+  to surface every finding; if you want to silence findings at the
+  CLI layer, use `seogeo.toml`'s `[ignore]` block. The two surfaces
+  serve different audiences: the plugin is editorial workflow, the
+  CLI is build-gating.
+
+## [0.3.0] - 2026-05-01
+
+Adds an LLM-assisted authoring flow for the truth manifest
+(`facts.json`) — a structured assertion of who the organization is,
+what the products are, and the terminology to use/avoid. AI
+assistants and search crawlers read it for citation grounding;
+authoring it well is a content task, not engineering, but the
+manifest's failure mode (a published manifest with hallucinated
+content) is high-impact.
+
+The plugin frames the question, validates the answer, and persists
+the result. The editor's LLM generates. The split is enforced by
+the prompt template, which mandates an interview phase before
+producing JSON: the LLM must ask up to 4 prioritized questions
+(terminology > identity > product/org split > descriptors) so the
+failure mode shifts from confident hallucination to honest gaps.
+
+**Compatibility:** verified against emdash `0.7.0` and `0.8.0`.
+
+### Added
+
+- **`/facts` admin page.** New entry in the plugin's adminPages.
+  Three-section UI: status of stored manifest, generate-prompt
+  (copy to clipboard for pasting into the editor's LLM), and
+  paste-and-validate (textarea with Validate + Save buttons; Save
+  is gated on a clean validation).
+- **Manifest-aware truth scoring.** `scoreIntelligence` now accepts
+  an optional manifest argument; the plugin reads it from KV
+  (`facts:current`) before scoring and badges the dashboard widget's
+  truth stat with the actual signal source — `Truth (manifest+schema)`,
+  `Truth (schema only)`, etc. Closes the prior UX-honesty gap where
+  the truth score was computed in schema-only mode without telling
+  the editor.
+- **`FACTS001` / `FACTS003` findings** on /findings. Surface
+  "no manifest authored yet" and "manifest disagrees with on-page
+  schema.org" so editors discover the authoring flow through their
+  existing surface. Cached under `meta:facts-findings` and
+  refreshed on Refresh + on Save, so the data path reads at zero
+  WASM cost.
+- **Bridge surface:** `generateFactsPrompt(documents)` and
+  `validateFactsManifest(manifest, documents)` WASM exports.
+  `scoreIntelligence` gained an optional `manifest_json` parameter.
+
+### Changed
+
+- `wasm/aexeo_emdash_bridge_bg.d.ts` is now tracked in git
+  (gitignored everything else in `wasm/`). wasm-bindgen 0.2.118
+  doesn't emit a `_bg.d.ts` for the bundler target, so this file
+  is hand-maintained. The build script snapshots its contents
+  before each wasm-bindgen run and restores it (saving the new
+  emit under `.wasm-bindgen` for inspection) if a future toolchain
+  version begins emitting one — loud warning rather than silent
+  regression.
+
+### Notes for hosts upgrading from 0.2.x
+
+- A new sidebar entry "Truth manifest" appears under the plugin's
+  admin pages. No action required to enable.
+- The dashboard widget's truth-score label now reads
+  `Truth (schema only)` until a manifest is authored. Same number,
+  more honest framing — no behavioral change.
+- A new sitewide finding (`FACTS001`) appears on /findings until a
+  manifest is saved. Severity: warning. Authoring via the new
+  /facts page dismisses it.
+
 ## [0.2.0] - 2026-04-28
 
 Adds the long-asked clickable routes on the findings page. Block
@@ -153,7 +266,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.2.0...HEAD
+[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.4.0...HEAD
+[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
 [0.2.0]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.1.2...aexeo-emdash-v0.2.0
 [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

package/dist/admin/Facts.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Facts.d.ts","sourceRoot":"","sources":["../../src/admin/Facts.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAsC/B,wBAAgB,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAyLzC"}

package/dist/admin.d.ts

@@ -1,5 +1,7 @@
+import { Facts } from "./admin/Facts.js";
 import { Findings } from "./admin/Findings.js";
 export declare const pages: {
     "/findings": typeof Findings;
+    "/facts": typeof Facts;
 };
 //# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,eAAO,MAAM,KAAK;;CAEjB,CAAC"}
+{"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"}

package/dist/admin.js

@@ -1,20 +1,294 @@
-// src/admin/Findings.tsx
+// src/admin/Facts.tsx
 import { useCallback, useEffect, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 var PLUGIN_ID = "aexeo-seogeo";
 var API_BASE = "/_emdash/api";
+function Facts() {
+  const [data, setData] = useState(null);
+  const [loadError, setLoadError] = useState(null);
+  const [draft, setDraft] = useState("");
+  const [validation, setValidation] = useState(null);
+  const [busy, setBusy] = useState(null);
+  const [toast, setToast] = useState(null);
+  const loadCurrent = useCallback(async () => {
+    setLoadError(null);
+    try {
+      const res = await callRoute("data", {});
+      setData(res);
+      const stored = res.manifest;
+      if (stored !== null) {
+        setDraft(JSON.stringify(stored, null, 2));
+      }
+    } catch (err) {
+      setLoadError(err instanceof Error ? err.message : String(err));
+    }
+  }, []);
+  useEffect(() => {
+    void loadCurrent();
+  }, [loadCurrent]);
+  const onCopyPrompt = useCallback(async () => {
+    setBusy("prompt");
+    setToast(null);
+    try {
+      const res = await callRoute("prompt", {});
+      await navigator.clipboard.writeText(res.prompt);
+      setToast(
+        "Prompt copied to clipboard \u2014 paste it into Claude/GPT, answer the LLM's questions, then come back and paste the resulting JSON below."
+      );
+    } catch (err) {
+      setToast(
+        `Failed to generate prompt: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, []);
+  const onValidate = useCallback(async () => {
+    setBusy("validate");
+    setToast(null);
+    setValidation(null);
+    try {
+      const res = await callRoute("validate", {
+        manifest_json: draft
+      });
+      setValidation(res);
+    } catch (err) {
+      setToast(
+        `Validation failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, [draft]);
+  const onSave = useCallback(async () => {
+    setBusy("save");
+    setToast(null);
+    try {
+      await callRoute("save", { manifest_json: draft });
+      setToast("Manifest saved. Site truth score will reflect it on next refresh.");
+      await loadCurrent();
+    } catch (err) {
+      setToast(
+        `Save failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    } finally {
+      setBusy(null);
+    }
+  }, [draft, loadCurrent]);
+  const validationOk = validation !== null && validation.validation.valid && validation.validation.errors.length === 0 && validation.assessment.mismatches.filter((m) => m.severity === "error").length === 0;
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-6 p-4", children: [
+    /* @__PURE__ */ jsxs("header", { children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "Truth manifest" }),
+      /* @__PURE__ */ jsxs("p", { className: "mt-1 text-sm text-kumo-subtle", children: [
+        "Author a ",
+        /* @__PURE__ */ jsx("code", { children: "facts.json" }),
+        " using your LLM of choice. The plugin frames the question, validates the answer, and stores the result. Read",
+        " ",
+        /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: "https://github.com/schiste/Aexeo/blob/main/docs/facts-manifest.md",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            className: "text-kumo-link hover:underline",
+            children: "the authoring guide"
+          }
+        ),
+        " ",
+        "for the philosophy behind this flow."
+      ] })
+    ] }),
+    loadError !== null && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-3 text-sm text-red-700", children: [
+      "Failed to load manifest state: ",
+      loadError
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Status" }),
+      /* @__PURE__ */ jsx("p", { className: "mt-2 text-sm", children: data === null ? "Loading\u2026" : data.present ? "\u2713 A truth manifest is stored. Editing the JSON below replaces it on Save." : "No truth manifest stored. Generate the prompt below to author one." })
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "1. Generate authoring prompt" }),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-kumo-subtle", children: "Copies a populated prompt to your clipboard. Paste it into Claude/GPT/etc., answer the LLM's questions, and bring the resulting JSON back here." }),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          onClick: () => void onCopyPrompt(),
+          disabled: busy !== null,
+          className: "rounded bg-kumo-brand px-3 py-1.5 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50",
+          children: busy === "prompt" ? "Copying\u2026" : "Copy prompt"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "2. Paste & validate" }),
+      /* @__PURE__ */ jsx(
+        "textarea",
+        {
+          value: draft,
+          onChange: (e) => setDraft(e.target.value),
+          spellCheck: false,
+          rows: 16,
+          placeholder: '{ "version": 1, "organization": { ... }, ... }',
+          className: "w-full rounded border border-kumo-line bg-kumo-tint p-2 font-mono text-xs"
+        }
+      ),
+      /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => void onValidate(),
+            disabled: busy !== null || draft.trim().length === 0,
+            className: "rounded border border-kumo-line px-3 py-1.5 text-sm hover:bg-kumo-tint disabled:opacity-50",
+            children: busy === "validate" ? "Validating\u2026" : "Validate"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => void onSave(),
+            disabled: busy !== null || !validationOk,
+            title: validationOk ? "Save to KV" : "Run Validate first; only valid manifests can be saved.",
+            className: "rounded bg-kumo-brand px-3 py-1.5 text-sm font-medium text-white hover:bg-kumo-brand/90 disabled:opacity-50",
+            children: busy === "save" ? "Saving\u2026" : "Save"
+          }
+        )
+      ] })
+    ] }),
+    toast !== null && /* @__PURE__ */ jsx("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
+    validation !== null && /* @__PURE__ */ jsx(ValidationReport, { result: validation })
+  ] });
+}
+function ValidationReport({
+  result
+}) {
+  const errMismatches = result.assessment.mismatches.filter(
+    (m) => m.severity === "error"
+  );
+  const warnMismatches = result.assessment.mismatches.filter(
+    (m) => m.severity === "warning"
+  );
+  return /* @__PURE__ */ jsxs("section", { className: "space-y-3 rounded border border-kumo-line p-3", children: [
+    /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Validation result" }),
+    /* @__PURE__ */ jsxs("div", { className: "text-sm", children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        "Shape:",
+        " ",
+        /* @__PURE__ */ jsx("strong", { children: result.validation.valid ? "valid" : "invalid" }),
+        " ",
+        "\xB7 org",
+        " ",
+        result.validation.organization_present ? "present" : "missing",
+        " \xB7",
+        " ",
+        result.validation.product_count,
+        " products \xB7",
+        " ",
+        result.validation.preferred_term_count,
+        " preferred terms \xB7",
+        " ",
+        result.validation.forbidden_term_count,
+        " forbidden terms"
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        "Score: ",
+        /* @__PURE__ */ jsx("strong", { children: result.assessment.score }),
+        "/",
+        result.assessment.score_ceiling,
+        " \xB7 source =",
+        " ",
+        /* @__PURE__ */ jsx("code", { children: result.assessment.structured_truth_source }),
+        " \xB7",
+        " ",
+        result.assessment.pages_analyzed,
+        " pages,",
+        " ",
+        result.assessment.pages_with_schema,
+        " with schema.org"
+      ] })
+    ] }),
+    result.validation.errors.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Schema errors:" }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: result.validation.errors.map((e, i) => /* @__PURE__ */ jsx("li", { children: e }, i)) })
+    ] }),
+    result.validation.warnings.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-yellow-500/40 bg-yellow-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Schema warnings:" }),
+      /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: result.validation.warnings.map((w, i) => /* @__PURE__ */ jsx("li", { children: w }, i)) })
+    ] }),
+    errMismatches.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-red-500/40 bg-red-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Mismatches with site (errors):" }),
+      /* @__PURE__ */ jsx(MismatchList, { items: errMismatches })
+    ] }),
+    warnMismatches.length > 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-yellow-500/40 bg-yellow-500/10 p-2 text-sm", children: [
+      /* @__PURE__ */ jsx("strong", { children: "Mismatches with site (warnings):" }),
+      /* @__PURE__ */ jsx(MismatchList, { items: warnMismatches })
+    ] }),
+    result.validation.errors.length === 0 && result.assessment.mismatches.length === 0 && /* @__PURE__ */ jsxs("div", { className: "rounded border border-green-500/40 bg-green-500/10 p-2 text-sm", children: [
+      "\u2713 Manifest is valid and agrees with on-page schema.org. Click",
+      " ",
+      "Save to persist."
+    ] })
+  ] });
+}
+function MismatchList({
+  items
+}) {
+  return /* @__PURE__ */ jsx("ul", { className: "mt-1 list-disc pl-5", children: items.map((m, i) => /* @__PURE__ */ jsxs("li", { children: [
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.route }),
+    " \xB7 ",
+    m.field,
+    ": expected",
+    " ",
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.expected }),
+    ", observed",
+    " ",
+    /* @__PURE__ */ jsx("code", { className: "text-xs", children: m.observed }),
+    " ",
+    /* @__PURE__ */ jsxs("span", { className: "text-xs text-kumo-subtle", children: [
+      "(",
+      m.source,
+      ")"
+    ] })
+  ] }, i)) });
+}
+async function callRoute(kind, extra) {
+  const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/facts`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-EmDash-Request": "1"
+    },
+    body: JSON.stringify({ kind, ...extra })
+  });
+  const body = await res.json();
+  if (body.error !== void 0) {
+    throw new Error(`${body.error.code}: ${body.error.message}`);
+  }
+  if (body.data === void 0) {
+    throw new Error(`Empty response (HTTP ${res.status})`);
+  }
+  return body.data;
+}
+
+// src/admin/Findings.tsx
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var PLUGIN_ID2 = "aexeo-seogeo";
+var API_BASE2 = "/_emdash/api";
 function Findings() {
-  const [state, setState] = useState({
+  const [state, setState] = useState2({
     loading: true,
     error: null,
     payload: null
   });
-  const [refreshing, setRefreshing] = useState(false);
-  const [toast, setToast] = useState(null);
-  const load = useCallback(async () => {
+  const [refreshing, setRefreshing] = useState2(false);
+  const [toast, setToast] = useState2(null);
+  const load = useCallback2(async () => {
     setState((s) => ({ ...s, loading: true, error: null }));
     try {
-      const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/data`, {
+      const res = await fetch(`${API_BASE2}/plugins/${PLUGIN_ID2}/data`, {
         method: "POST",
         headers: csrfHeaders(),
         body: "{}"
@@ -30,11 +304,11 @@ function Findings() {
       });
     }
   }, []);
-  const refresh = useCallback(async () => {
+  const refresh = useCallback2(async () => {
     setRefreshing(true);
     setToast(null);
     try {
-      const res = await fetch(`${API_BASE}/plugins/${PLUGIN_ID}/refresh`, {
+      const res = await fetch(`${API_BASE2}/plugins/${PLUGIN_ID2}/refresh`, {
         method: "POST",
         headers: csrfHeaders(),
         body: "{}"
@@ -60,20 +334,20 @@ function Findings() {
       setRefreshing(false);
     }
   }, []);
-  useEffect(() => {
+  useEffect2(() => {
     void load();
   }, [load]);
   if (state.loading && state.payload === null) {
-    return /* @__PURE__ */ jsx("div", { className: "p-4 text-sm text-kumo-subtle", children: "Loading findings\u2026" });
+    return /* @__PURE__ */ jsx2("div", { className: "p-4 text-sm text-kumo-subtle", children: "Loading findings\u2026" });
   }
   if (state.error !== null) {
-    return /* @__PURE__ */ jsxs("div", { className: "p-4", children: [
-      /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
-      /* @__PURE__ */ jsxs("p", { className: "mt-2 rounded border border-red-500/40 bg-red-500/10 p-3 text-sm text-red-700", children: [
+    return /* @__PURE__ */ jsxs2("div", { className: "p-4", children: [
+      /* @__PURE__ */ jsx2("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+      /* @__PURE__ */ jsxs2("p", { className: "mt-2 rounded border border-red-500/40 bg-red-500/10 p-3 text-sm text-red-700", children: [
         "Failed to load: ",
         state.error
       ] }),
-      /* @__PURE__ */ jsx(
+      /* @__PURE__ */ jsx2(
         "button",
         {
           type: "button",
@@ -86,17 +360,17 @@ function Findings() {
   }
   const payload = state.payload;
   if (payload === null) {
-    return /* @__PURE__ */ jsx("div", { className: "p-4 text-sm text-kumo-subtle", children: "No data." });
+    return /* @__PURE__ */ jsx2("div", { className: "p-4 text-sm text-kumo-subtle", children: "No data." });
   }
   const routesByPath = /* @__PURE__ */ new Map();
   for (const route of payload.routes) {
     routesByPath.set(route.route, route);
   }
-  return /* @__PURE__ */ jsxs("div", { className: "space-y-4 p-4", children: [
-    /* @__PURE__ */ jsxs("header", { className: "flex items-center justify-between gap-4", children: [
-      /* @__PURE__ */ jsxs("div", { children: [
-        /* @__PURE__ */ jsx("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
-        /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-kumo-subtle", children: payload.totals.findings === 0 ? /* @__PURE__ */ jsx(Fragment, { children: "No findings yet \u2014 click Refresh to evaluate the site." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+  return /* @__PURE__ */ jsxs2("div", { className: "space-y-4 p-4", children: [
+    /* @__PURE__ */ jsxs2("header", { className: "flex items-center justify-between gap-4", children: [
+      /* @__PURE__ */ jsxs2("div", { children: [
+        /* @__PURE__ */ jsx2("h1", { className: "text-xl font-semibold", children: "SEO findings" }),
+        /* @__PURE__ */ jsx2("p", { className: "mt-1 text-sm text-kumo-subtle", children: payload.totals.findings === 0 ? /* @__PURE__ */ jsx2(Fragment, { children: "No findings yet \u2014 click Refresh to evaluate the site." }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
           payload.totals.findings,
           " findings across ",
           payload.totals.routes,
@@ -108,7 +382,7 @@ function Findings() {
           " warnings."
         ] }) })
       ] }),
-      /* @__PURE__ */ jsx(
+      /* @__PURE__ */ jsx2(
         "button",
         {
           type: "button",
@@ -119,29 +393,29 @@ function Findings() {
         }
       )
     ] }),
-    toast !== null && /* @__PURE__ */ jsx("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
-    payload.sitewideFindings.length > 0 && /* @__PURE__ */ jsxs("section", { className: "rounded border border-kumo-line p-3", children: [
-      /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium", children: "Sitewide" }),
-      /* @__PURE__ */ jsx("ul", { className: "mt-2 space-y-1 text-sm", children: payload.sitewideFindings.map((finding, i) => /* @__PURE__ */ jsxs("li", { className: "flex items-start gap-2", children: [
-        /* @__PURE__ */ jsx(SeverityBadge, { severity: finding.severity }),
-        /* @__PURE__ */ jsx("code", { className: "font-mono text-xs", children: finding.rule_id }),
-        /* @__PURE__ */ jsx("span", { className: "flex-1", children: finding.message })
+    toast !== null && /* @__PURE__ */ jsx2("div", { className: "rounded border border-kumo-line bg-kumo-tint p-3 text-sm", children: toast }),
+    payload.sitewideFindings.length > 0 && /* @__PURE__ */ jsxs2("section", { className: "rounded border border-kumo-line p-3", children: [
+      /* @__PURE__ */ jsx2("h2", { className: "text-sm font-medium", children: "Sitewide" }),
+      /* @__PURE__ */ jsx2("ul", { className: "mt-2 space-y-1 text-sm", children: payload.sitewideFindings.map((finding, i) => /* @__PURE__ */ jsxs2("li", { className: "flex items-start gap-2", children: [
+        /* @__PURE__ */ jsx2(SeverityBadge, { severity: finding.severity }),
+        /* @__PURE__ */ jsx2("code", { className: "font-mono text-xs", children: finding.rule_id }),
+        /* @__PURE__ */ jsx2("span", { className: "flex-1", children: finding.message })
       ] }, i)) })
     ] }),
-    payload.findings.length === 0 ? /* @__PURE__ */ jsx("p", { className: "text-sm text-kumo-subtle", children: payload.totals.documentsIndexed === 0 ? "No documents indexed \u2014 click Refresh to do an initial sweep." : "All indexed documents are clean." }) : /* @__PURE__ */ jsx("div", { className: "overflow-x-auto rounded border border-kumo-line", children: /* @__PURE__ */ jsxs("table", { className: "w-full text-left text-sm", children: [
-      /* @__PURE__ */ jsx("thead", { className: "bg-kumo-tint", children: /* @__PURE__ */ jsxs("tr", { children: [
-        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Route" }),
-        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Rule" }),
-        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Severity" }),
-        /* @__PURE__ */ jsx("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Message" })
+    payload.findings.length === 0 ? /* @__PURE__ */ jsx2("p", { className: "text-sm text-kumo-subtle", children: payload.totals.documentsIndexed === 0 ? "No documents indexed \u2014 click Refresh to do an initial sweep." : "All indexed documents are clean." }) : /* @__PURE__ */ jsx2("div", { className: "overflow-x-auto rounded border border-kumo-line", children: /* @__PURE__ */ jsxs2("table", { className: "w-full text-left text-sm", children: [
+      /* @__PURE__ */ jsx2("thead", { className: "bg-kumo-tint", children: /* @__PURE__ */ jsxs2("tr", { children: [
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Route" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Rule" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Severity" }),
+        /* @__PURE__ */ jsx2("th", { className: "px-3 py-2 font-medium text-kumo-subtle", children: "Message" })
       ] }) }),
-      /* @__PURE__ */ jsx("tbody", { children: payload.findings.map((finding, i) => {
+      /* @__PURE__ */ jsx2("tbody", { children: payload.findings.map((finding, i) => {
         const routeInfo = routesByPath.get(finding.route);
-        return /* @__PURE__ */ jsxs("tr", { className: "border-t border-kumo-line", children: [
-          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx(RouteLinks, { finding, info: routeInfo }) }),
-          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx("code", { className: "rounded bg-kumo-tint px-1.5 py-0.5 font-mono text-xs", children: finding.rule_id }) }),
-          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx(SeverityBadge, { severity: finding.severity }) }),
-          /* @__PURE__ */ jsx("td", { className: "px-3 py-2 align-top", children: finding.message })
+        return /* @__PURE__ */ jsxs2("tr", { className: "border-t border-kumo-line", children: [
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2(RouteLinks, { finding, info: routeInfo }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2("code", { className: "rounded bg-kumo-tint px-1.5 py-0.5 font-mono text-xs", children: finding.rule_id }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: /* @__PURE__ */ jsx2(SeverityBadge, { severity: finding.severity }) }),
+          /* @__PURE__ */ jsx2("td", { className: "px-3 py-2 align-top", children: finding.message })
         ] }, i);
       }) })
     ] }) })
@@ -152,18 +426,18 @@ function RouteLinks({
   info
 }) {
   if (info === void 0) {
-    return /* @__PURE__ */ jsx("span", { className: "font-mono text-xs", children: finding.route });
+    return /* @__PURE__ */ jsx2("span", { className: "font-mono text-xs", children: finding.route });
   }
-  return /* @__PURE__ */ jsxs("span", { className: "space-x-2", children: [
-    info.editUrl !== "" ? /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsxs2("span", { className: "space-x-2", children: [
+    info.editUrl !== "" ? /* @__PURE__ */ jsx2(
       "a",
       {
         href: info.editUrl,
         className: "font-mono text-xs text-kumo-link hover:underline",
         children: finding.route
       }
-    ) : /* @__PURE__ */ jsx("span", { className: "font-mono text-xs", children: finding.route }),
-    info.publishedUrl !== "" && /* @__PURE__ */ jsx(
+    ) : /* @__PURE__ */ jsx2("span", { className: "font-mono text-xs", children: finding.route }),
+    info.publishedUrl !== "" && /* @__PURE__ */ jsx2(
       "a",
       {
         href: info.publishedUrl,
@@ -173,12 +447,12 @@ function RouteLinks({
         children: "live \u2197"
       }
     ),
-    info.status !== "" && info.status !== "published" && /* @__PURE__ */ jsx("span", { className: "text-xs text-kumo-subtle", children: info.status })
+    info.status !== "" && info.status !== "published" && /* @__PURE__ */ jsx2("span", { className: "text-xs text-kumo-subtle", children: info.status })
   ] });
 }
 function SeverityBadge({ severity }) {
   const classes = severity === "error" ? "bg-red-500/10 text-red-700 border-red-500/40" : severity === "warning" ? "bg-yellow-500/10 text-yellow-800 border-yellow-500/40" : "bg-kumo-tint text-kumo-subtle border-kumo-line";
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx2(
     "span",
     {
       className: `inline-block rounded border px-1.5 py-0.5 text-xs font-medium ${classes}`,
@@ -207,7 +481,11 @@ function unwrap(body, res) {
 
 // src/admin.tsx
 var pages = {
-  "/findings": Findings
+  "/findings": Findings,
+  // /facts is the truth-manifest authoring page. Block Kit can't render
+  // a textarea or copy-to-clipboard button, so this path goes through
+  // the React adminEntry. Same mechanism as /findings.
+  "/facts": Facts
 };
 export {
   pages

package/dist/configured.d.ts

@@ -1,3 +1,4 @@
+import type { Suppression } from "./suppressions.js";
 export interface ConfiguredPluginOptions {
     /**
      * emdash collections the Refresh button sweeps. Comes through from
@@ -6,6 +7,13 @@ export interface ConfiguredPluginOptions {
      * (`["posts", "pages"]`).
      */
     collections?: readonly string[];
+    /**
+     * Editor-workflow suppressions. See `Suppression` in suppressions.ts
+     * for the rule shape and matching semantics. Compiled once at plugin
+     * construction; the resulting filter is captured in the closures
+     * attached to the route handlers and the afterSave hook.
+     */
+    suppressions?: readonly Suppression[];
 }
 export declare function createPlugin(options?: ConfiguredPluginOptions): unknown;
 export default createPlugin;

package/dist/configured.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AA8EA,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CA0E3E;AAID,eAAe,YAAY,CAAC"}
+{"version":3,"file":"configured.d.ts","sourceRoot":"","sources":["../src/configured.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoDrD,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CA+F3E;AAID,eAAe,YAAY,CAAC"}