cremote/CHANGELOG.md

Cremote Changelog

Version 2.2.1-contrast-detection-fix (2025-12-09)

Improvements: Enhanced Text Color Detection

This patch improves the text color detection algorithm to properly handle complex nested DOM structures.

What Changed

Enhanced Recursive Search Algorithm:

• Previous version checked only direct children
• New version recursively searches all descendant elements
• Finds the element with the most text content (ignores <br>, empty elements)
• Properly handles structures like <a><span>text</span><br></a>

Example Fix:

<a style="color: rgb(12, 113, 195)">
  <span style="color: #ffffff;">314-560-7171</span>
  <br>
</a>

• Before: Used <a> color (blue) = 4.17:1 contrast ❌
• After: Uses <span> color (white) = 21.00:1 contrast ✅

Modified Files:

• daemon/daemon.go - Lines 9301-9354: Implemented recursive findTextBearingElement() function

Version Updates:

• Daemon: 2.2.1-contrast-detection-fix
• MCP Server: 2.2.1-contrast-detection-fix
• CLI: 2.2.1

---

Version 2.2.0-contrast-detection-fix (2025-12-09)

Major Improvements: Contrast Detection

This release fixes three critical issues in the WCAG contrast checking functionality that were causing false positives and incorrect reporting.

Fixed Issues

1. Gradient Background Detection ✅

   • Problem: Text on gradient backgrounds was incorrectly reported as white-on-white (1:1 ratio)
   • Fix: Enhanced gradient detection to walk up the DOM tree and find gradients on parent elements
   • Impact: Eliminates false positives for text on gradient backgrounds (e.g., hero sections with gradient overlays)

2. Solid Background Priority ✅

   • Problem: Gradient backgrounds were incorrectly applied to elements with solid backgrounds
   • Fix: Modified gradient detection to stop when encountering solid backgrounds - only applies gradients when no solid background exists between element and gradient
   • Impact: Ensures accurate background color detection for elements with solid backgrounds

3. Child Element Text Color Detection ✅

   • Problem: Tool used parent element's color (e.g., <a>) instead of child element's color (e.g., <span>)
   • Fix: Added recursive search to find the descendant element with the most text content and use its color
   • Impact: Accurate text color detection for complex DOM structures like <a><span>text</span><br></a>

Technical Details

Modified Files:

• daemon/daemon.go - Lines 9152-9220: Enhanced analyzeGradientContrast() function
• daemon/daemon.go - Lines 9305-9340: Updated background detection logic
• daemon/daemon.go - Lines 9301-9354: Enhanced text color detection with recursive search

Version Updates:

• Daemon: 2.2.0-contrast-detection-fix
• MCP Server: 2.2.0-contrast-detection-fix
• CLI: 2.2.0

Testing

Test cases that now work correctly:

• ✅ White text on gradient backgrounds (e.g., linear-gradient(rgb(12, 90, 201) 0%, rgb(0, 0, 0) 100%))
• ✅ Text on solid backgrounds with gradient ancestors
• ✅ Links with styled child spans (<a><span style="color: ...">text</span></a>)

Upgrade Notes

After deploying this version:

1. Restart the cremote daemon service
2. Restart the MCP server or Augment extension
3. Re-run contrast audits on pages that previously showed false positives

Documentation

See GRADIENT_CONTRAST_FIX.md for detailed technical documentation of the fixes.

---

Version 2.1.0-visibility-fix

Improvements

• Enhanced visibility detection for contrast checking
• Improved handling of hidden elements

---

Version 2.0.1

Initial Release

• Core cremote functionality
• Browser automation via Chrome DevTools Protocol
• Accessibility testing tools
• MCP server integration