Add Sequences class with automatic compactification option on dispose

[konard]

🎯 Summary

Implements automatic compactification (deduplication) functionality for sequences by adding a new Sequences<TLinkAddress> class with optional automatic compactification on dispose.

📋 Implementation Details

🔧 Core Features

• New Sequences<TLinkAddress> Class: Extends LinksDisposableDecoratorBase to provide compactification functionality
• Configurable Automatic Compactification: Optional feature enabled via constructor parameter
• Manual Compactification: Compact() method for on-demand deduplication
• Smart Duplicate Detection: Identifies links with identical source and target pairs
• Point Link Protection: Skips self-referencing point links during compactification
• Robust Error Handling: Gracefully handles disposal edge cases

🏗️ Architecture

The implementation follows the existing decorator pattern used throughout the codebase:

// Usage examples
var sequences = new Sequences<uint>(links, enableAutomaticCompactification: true);
// ... work with links
sequences.Dispose(); // Automatically compacts duplicates

// Manual compactification
var sequences = new Sequences<uint>(links, enableAutomaticCompactification: false);
sequences.Compact(); // Manual compaction

⚙️ Compactification Algorithm

1. Scan Phase: Iterate through all links using Each() method
2. Detection Phase: Group links by (source, target) key pairs
3. Merge Phase: Use existing MergeAndDelete() to merge duplicates
4. Preservation: Skip point links to maintain referential integrity

🧪 Comprehensive Testing

Added SequencesTests.cs with complete test coverage:

• ✅ Automatic compactification on dispose
• ✅ Manual compactification via Compact() method
• ✅ Point link preservation during compactification
• ✅ Multiple dispose calls safety
• ✅ Configuration option validation

🔍 Technical Implementation

Key Components

• Sequences<TLinkAddress>: Main class implementing compactification logic
• FindDuplicateLinks(): Efficient duplicate detection algorithm
• Compact(): Public API for manual compactification
• Disposal Override: Automatic compactification integration

Performance Considerations

• Uses dictionary-based deduplication for O(n) complexity
• Leverages existing MergeAndDelete infrastructure for consistency
• Minimal memory overhead with efficient link scanning

🎯 Fixes

Closes #97 - Add an option for automatic compactification (deduplication) of all sequences on Sequences' Dispose

---

🤖 Generated with Claude Code