Skip to content

feat(audit): eds_audit_report — shareable site-health report (ADR-014) - #10

Merged
focusgts merged 4 commits into
mainfrom
feat/audit-report
Aug 16, 2026
Merged

focusgts merged 4 commits into
mainfrom
feat/audit-report

Conversation

@focusgts

Copy link
Copy Markdown
Member

Shareable site-health report (ADR-014)

Makes the audit's value visible and shareable. eds_audit_report runs the site audit and returns a self-contained, theme-aware HTML report (inline CSS/SVG, no external assets, no dependencies):

  • Overall grade + summary.
  • Per-dimension health scores (SEO, accessibility, performance, freshness, links, sitemap) — derived transparently from findings; dimensions that can't run show "not run", never a fake score.
  • Prioritized issue list — identical findings collapsed across pages ("N pages: …") — each with its suggested fix.

Same options as eds_audit_site; read-only. The bridge asset for the Adobe/prospect conversation.

Verification

  • 221 tests (7 report: self-contained HTML, grouping, skipped-as-"not run", honest scoring, escaping, handler).
  • Live-rendered from a real site (adobe/helix-website) and published as a shareable artifact to confirm it renders beautifully in both light and dark.

37 tools. Docs + hero/metadata bumped to 37.

…ealth report (ADR-014)

Makes the audit's value visible: run the site audit and get back a beautiful,
theme-aware HTML report (inline CSS/SVG, no external assets, no deps) — overall
grade, per-dimension health scores, and a prioritized issue list (identical
findings collapsed across pages) each with its suggested fix. Dimensions that
can't run show "not run", never a fake score; the health score is derived
transparently from findings. Same options as eds_audit_site; read-only.

Live-rendered from a real site (adobe/helix-website). 37 tools; +7 tests; full
suite 221 passing. Hero/metadata bumped to 37.
…lette, severity stripes

Circular ring gauges (per-dimension + a large overall grade gauge), a considered
palette with a single indigo accent kept separate from the semantic good/warning/
critical colors, a monospace face for the metrics (tabular numerals), count pills,
and severity-striped issue cards. Still fully self-contained + theme-aware.
…edirects in one reversible batch (ADR-015)

Closes the audit→fix loop. Findings now carry a stable `code` and, where a
shipped writer can repair them, a `fix` descriptor (SEO title/description →
eds_fix_metadata; broken-link 404s → eds_fix_redirect). New tool eds_fix_audit
takes agent-supplied metadata and/or redirect values (never fabricates copy) and
pushes every changed doc — metadata pages + /redirects.json — in one withUndo
push, so a single eds_da_rollback reverses the whole mixed batch. dryRun previews
the combined plan; publish:true makes it live. Pure orchestration over the
ADR-011/013 writers; no new write logic.

The report marks repairable findings with a '✦ Fixable' chip and an honest
'N of M can be fixed in place' lead (references eds_fix_audit — the two ship
together). Success counts derive from result.succeeded, never the plan, so a
partial write failure never reads as success; a published batch's undo message
warns that rolled-back docs must be republished to make the revert live (both
from adversarial review). 38 tools total.

Report visual pass also folded in: score gauges, even 3x2 grid, hover explainers.
@focusgts
focusgts merged commit f11697a into main Aug 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant