RELEASE_SUMMARY_1.8.10 - Alteriom/painlessMesh GitHub Wiki

Release Summary: v1.8.10

Version: 1.8.10
Release Date: November 18, 2025
Type: Patch Release (Bug Fix)
Status: ✅ Ready for Release

📝 Quick Summary

Version 1.8.10 fixes a critical bridge discovery issue where newly connected nodes were not reliably receiving bridge status information. The fix changes the delivery mechanism from broadcast to direct single message, ensuring immediate and reliable bridge discovery.

🎯 What Changed

Single Bug Fix

  • Bridge Status Discovery - Fixed newly connected nodes not receiving bridge status
    • Changed from broadcast (routing=2) to direct single message (routing=1)
    • Added 500ms connection stability delay
    • Nodes now discover bridges within 500ms (previously up to 30 seconds)
    • Resolves GitHub issue #135

📦 Files Updated

Version Files (8 files)

✅ library.properties → 1.8.10
✅ library.json → 1.8.10
✅ package.json → 1.8.10
✅ src/painlessMesh.h → 1.8.10 (date: 2025-11-18)
✅ src/AlteriomPainlessMesh.h → 1.8.10 (version defines)
✅ CHANGELOG.md → Added [1.8.10] entry
✅ RELEASE_NOTES_1.8.10.md → Created
✅ RELEASE_CHECKLIST_1.8.10.md → Created

Source Code

  • src/arduino/wifi.hpp - Bridge status delivery fix (line ~809)

✅ Version Consistency Verification

All version numbers are consistent across files:

library.properties: 1.8.10
library.json: 1.8.10
package.json: 1.8.10
src/painlessMesh.h: 1.8.10
src/AlteriomPainlessMesh.h: 1.8.10
CHANGELOG.md: [1.8.10] - 2025-11-18

🚀 Release Steps

Next Steps (To be performed by release manager)

  1. Review and Merge PR

    # Review all changes in the PR
# Merge to main branch when approved

  2. Trigger Release (Automatic via GitHub Actions)

    # Push to main branch triggers automated release
git push origin main

# Or manually tag if needed:
git tag -a v1.8.10 -m "release: v1.8.10 - Bridge status discovery fix"
git push origin v1.8.10

  3. Automated Publication

    • ✅ GitHub Release created automatically
    • ✅ NPM package published automatically
    • ✅ GitHub Packages updated automatically
    • ✅ PlatformIO registry published automatically
    • ✅ GitHub Wiki synchronized automatically

  4. Manual Verification (After automation completes)

📋 Documentation Provided

Release Documentation

  1. RELEASE_NOTES_1.8.10.md

    • Comprehensive release notes with technical details
    • Upgrade guide and migration instructions
    • Testing recommendations
    • Performance characteristics

  2. RELEASE_CHECKLIST_1.8.10.md

    • Complete pre-release checklist (all items completed)
    • Release process step-by-step
    • Post-release tasks
    • Verification commands
    • Rollback procedures

  3. CHANGELOG.md

    • Updated with [1.8.10] entry
    • Detailed fix description
    • References GitHub issue #135

  4. RELEASE_SUMMARY_1.8.10.md (This file)

    • Quick overview for release manager
    • Status summary
    • Next steps

🎯 Impact Assessment

User Impact

  • Positive: Immediate and reliable bridge discovery for new nodes
  • Risk: Very low - focused bug fix with no API changes
  • Compatibility: 100% backward compatible

Upgrade Recommendation

  • Immediate: For systems with frequent node connections
  • Standard: For production deployments
  • Optional: For stable networks with infrequent changes

📊 Quality Metrics

Code Quality

  • ✅ Focused, targeted fix (single file, specific function)
  • ✅ No breaking changes
  • ✅ Backward compatible
  • ✅ Well-documented with comments

Documentation Quality

  • ✅ Comprehensive release notes
  • ✅ Detailed checklist
  • ✅ Updated changelog
  • ✅ Version consistency verified

Testing

  • ✅ Fix addresses reported issue
  • ✅ Solution validated
  • ✅ No regression risk identified

🔍 Related Issues

  • Resolves: GitHub issue #135 - "The latest fix does not work"
  • Previous Related: Issues #117, #108, #89 (bridge discovery improvements)

📞 Support & Resources

✨ Summary for Announcement

AlteriomPainlessMesh v1.8.10 Released!

This patch release fixes a critical bridge discovery issue where newly connected nodes were not reliably receiving bridge status information. The fix improves bridge discovery time from up to 30 seconds down to just 500ms by using direct message delivery instead of broadcast.

Key Improvement: Nodes now discover bridges immediately upon connection

Compatibility: 100% backward compatible - just update and deploy!

Install:

  • Arduino: Update via Library Manager
  • PlatformIO: lib_deps = alteriom/AlteriomPainlessMesh@^1.8.10
  • NPM: npm install @alteriom/[email protected]

Prepared by: GitHub Copilot Documentation Specialist
Date: November 18, 2025
Status: ✅ All documentation complete and ready for release