Skip to content

fix(report): pair path churn for direct deltas - #345

Merged
BenSheridanEdwards merged 1 commit into
mainfrom
fix/report-path-correspondence
Aug 6, 2026
Merged

fix(report): pair path churn for direct deltas#345
BenSheridanEdwards merged 1 commit into
mainfrom
fix/report-path-correspondence

Conversation

@BenSheridanEdwards

Copy link
Copy Markdown
Owner

Why does this feature exist?

Wrapper refactors can hide genuine restyles inside one-sided DOM inventories. Certification should stay conservative, but the report should show direct before/after values when the same element moved to a new path.

What changed?

  • Added report-only unique correspondence using tag, x/y/width and own-text length.
  • Re-runs the existing differ on a remapped presentation copy of the base map.
  • Ambiguous or legacy candidates remain unpaired.
  • Raw findings, reviewable counts, approval semantics and exit codes are unchanged.
  • Added unit, end-to-end, documentation and changelog coverage.

Behavioural Proof (with video and screenshots)

Not applicable — generated Markdown report behaviour is asserted by end-to-end fixtures and reproduced against the public Fleet PR #1178 map pair.

Fleet reproduction:

  • headline: 4 DOM change(s) · 32 computed-style difference(s) instead of raw path inventory noise
  • 2 elements added, 4 elements restyled
  • pool labels: font-size 12px → 13.3333px
  • raw certification remains 54 DOM / 1326 style / 84 state

Verification Summary

  • npm test — 652/652 passed
  • npm run demo:check — passed
  • build, typecheck, lint, format and privacy checks — passed
  • real Fleet PR #1178 maps regenerated and both composite and annotated crops inspected
  • exact head: c8a4f225f7afff42f2c7fd0981e6de86302d07e8

Derive a conservative before→after correspondence among uniquely signed
DOM-removed vs DOM-added paths (tag + rect x/y/width + ownTextLength, shared
structural prefix) during report prep. Remap matched before paths and re-diff
for presentation so wrapper moves collapse and true property deltas pair, while
raw findings, counts, exit codes, and approval gates stay path-certified.
@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown

🗺️ StyleProof report

📊 View the side-by-side visual report →


Coverage, determinism, or report/diff consistency evidence is incomplete — repair the capture or reflow source; visual approval cannot clear this failure.

@BenSheridanEdwards
BenSheridanEdwards merged commit cd05d60 into main Aug 6, 2026
12 checks 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