BAC4 v2.5.1 - Critical Bug Fixes

🐛 Critical Bug Fixes

This patch release addresses critical bugs affecting snapshot isolation and edge label persistence.

Snapshot Isolation Fixed

• Color contamination eliminated - Changes in one snapshot no longer affect other snapshots
• Snapshot-varying properties (label, color, description, status, icon, shape) now stored exclusively in snapshot.nodeProperties
• Ensures true temporal accuracy for architecture evolution tracking

Edge Label Persistence Fixed

• Edge labels persist correctly after file reload
• Eliminated data duplication bugs (direction stored in both properties and style)
• Fixed object spread ordering issues that caused value overwrites

Force Save Before Snapshot Switch

• Prevents data loss from auto-save race conditions
• All changes persisted before context switch

📊 Technical Details

Bundle Size: 754.1kb
Tests: All passing
TypeScript Errors: 0

📦 Installation

Via BRAT (Recommended)

1. Install BRAT plugin
2. Add: DavidROliverBA/bac4
3. Enable BAC4
4. Reload Obsidian

Manual Installation

1. Download bac4-v2.5.1.zip
2. Extract to vault/.obsidian/plugins/bac4/
3. Enable in Obsidian settings
4. Reload Obsidian

✨ All v2.5.0 Features Included

• ✅ Dual-file format (.bac4 + .bac4-graph)
• ✅ Enhanced knowledge management
• ✅ Wardley Mapping support
• ✅ Timeline snapshots with isolation
• ✅ C4 diagram layers (7 layers)
• ✅ Cloud component libraries (AWS, Azure, GCP)
• ✅ Graph view with filtering
• ✅ AI integration
• ✅ Navigation system

🔄 Upgrade Path

From v2.5.0: Direct upgrade - fully backward compatible
From v2.4.0 or earlier: Automatic migration on first open

📚 Documentation

• README - Feature overview
• CLAUDE.md - Developer guide
• ROADMAP.md - Future plans

🙏 Acknowledgments

Built with Claude Code

Release Date: 2025-10-27