ktsu.BlastMerge.Core 1.0.19

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package ktsu.BlastMerge.Core --version 1.0.19
                    


                    

                
NuGet\Install-Package ktsu.BlastMerge.Core -Version 1.0.19
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="ktsu.BlastMerge.Core" Version="1.0.19" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="ktsu.BlastMerge.Core" Version="1.0.19" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="ktsu.BlastMerge.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add ktsu.BlastMerge.Core --version 1.0.19
                    


                    

                
#r "nuget: ktsu.BlastMerge.Core, 1.0.19"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#addin nuget:?package=ktsu.BlastMerge.Core&version=1.0.19
                    


                            Install ktsu.BlastMerge.Core as a Cake Addin
                        

                    

                
#tool nuget:?package=ktsu.BlastMerge.Core&version=1.0.19
                    


                            Install ktsu.BlastMerge.Core as a Cake Tool

ktsu.BlastMerge

Cross-repository file synchronization through intelligent iterative merging

Overview

BlastMerge is a revolutionary file synchronization tool that uses intelligent iterative merging to unify multiple versions of files across repositories, directories, and codebases. Unlike traditional diff tools, BlastMerge progressively merges file versions by finding the most similar pairs and resolving conflicts interactively, ultimately synchronizing entire file ecosystems into a single, unified version.

🚀 Primary Feature: Iterative File Synchronization

The Problem

When working across multiple repositories, branches, or environments, the same files often diverge into multiple versions with overlapping changes. Traditional merge tools handle two-way merges, but when you have 3, 5, or 10+ versions of the same file scattered across different locations, manual synchronization becomes a nightmare.

The Solution: Iterative Merging

BlastMerge solves this by:

  1. Smart Discovery: Automatically finds all versions of a file across directories/repositories
  2. Hash-Based Grouping: Groups identical files and identifies unique versions
  3. Similarity Analysis: Calculates similarity scores between all version pairs
  4. Optimal Merge Order: Progressively merges the most similar versions first to minimize conflicts
  5. Interactive Resolution: Visual TUI for resolving conflicts block-by-block
  6. Cross-Repository Sync: Updates all file locations with the final merged result

Real-World Use Cases

  • Multi-Repository Synchronization: Sync the same configuration files across microservices
  • Branch Consolidation: Merge scattered feature branch changes before cleanup
  • Environment Alignment: Unify deployment scripts across dev/staging/prod environments
  • Code Migration: Consolidate similar files when merging codebases
  • Documentation Sync: Align README files across related projects

Features

🔄 Iterative Merging Engine

  • Smart File Detection: Automatically finds and groups identical file versions by hash
  • Similarity-Based Progression: Uses advanced algorithms to find the most similar files and merge them in optimal order
  • Cross-Repository Updates: Synchronizes all file locations with the merged result
  • Progressive Conflict Reduction: Each merge reduces complexity for subsequent merges
  • Interactive Conflict Resolution: Visual TUI for resolving merge conflicts block-by-block
  • Version Tracking: Maintains awareness of which files need updating across all locations

📊 Advanced File Analysis

  • Hash-Based Comparison: Fast file comparison using content hashing for instant duplicate detection
  • Content Similarity Scoring: Sophisticated algorithms to determine merge order
  • Multiple Diff Formats:
    • Change Summary (added/removed lines only)
    • Git-style diff (full context)
    • Rich colored diff (visual formatting)
  • Side-by-Side Display: Context-aware diff visualization with intelligent file ordering

🔧 Repository & Directory Operations

  • Directory Comparison: Compare entire directories with customizable file patterns
  • Recursive Search: Deep directory traversal to find all file versions
  • Batch Synchronization: Update multiple file locations simultaneously
  • Safe Operations: Built-in error handling and rollback capabilities

đŸ’ģ Interactive Experience

  • Rich Terminal Interface: Colored output and intuitive navigation with Spectre.Console
  • Command History: Arrow key navigation through previous inputs with persistent history
  • Default Values: Smart defaults based on most recently used inputs
  • Progress Indicators: Real-time feedback for long-running operations
  • Block-Level Control: Choose how to handle each difference (keep, remove, use version 1/2, use both)

Installation

Add the NuGet package:

dotnet add package ktsu.BlastMerge

Usage

Primary Workflow: Iterative File Synchronization

# Launch interactive mode for iterative merging
BlastMerge.ConsoleApp

# Select "🔀 Iterative Merge Multiple Versions"
# 1. Specify the directory containing your repositories/projects
# 2. Enter the filename pattern (e.g., "README.md", "config.json", "*.yml")
# 3. Watch as BlastMerge finds all versions and merges them optimally
# 4. Resolve conflicts interactively when needed
# 5. All file locations are automatically updated with the unified result

Command Line Mode

# Quick comparison for files with the same name across directories
BlastMerge.ConsoleApp <directory> <filename>

Interactive Mode Options

  1. 🔀 Iterative merge multiple file versions - PRIMARY FEATURE - Cross-repository file synchronization
  2. 🔍 Compare files with same name across directories - Find and compare files with identical names
  3. 📁 Compare two directories - Full directory comparison with file patterns
  4. 📄 Compare two specific files - Direct file-to-file comparison
  5. ℹī¸ Show help - Comprehensive feature overview

Iterative Merge Deep Dive

  1. File Discovery: Scans directory tree for matching files
  2. Version Analysis: Groups identical files, identifies unique versions
  3. Similarity Calculation: Determines optimal merge sequence
  4. Progressive Merging: Merges most similar pairs first
  5. Conflict Resolution: Interactive TUI for each conflict block
  6. Cross-Repository Update: Writes merged result to all original locations
  7. Verification: Confirms all locations now contain identical, unified content

Why Iterative Merging?

Traditional tools merge two files at a time, requiring manual orchestration for multiple versions. BlastMerge's iterative approach:

  • Minimizes Conflicts: By merging similar versions first, later merges have fewer conflicts
  • Optimizes Decision Making: Present easier decisions first, complex conflicts last
  • Maintains Context: Each merge builds on previous decisions
  • Scales Naturally: Works equally well with 3 files or 30 files
  • Preserves Intent: Interactive resolution ensures human judgment guides the process

License

MIT License. Copyright (c) ktsu.dev

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.20 129 6/5/2025
1.0.19 132 6/3/2025
1.0.18 129 6/3/2025
1.0.17 128 6/3/2025
1.0.16 130 6/3/2025
1.0.15 132 6/3/2025
1.0.14 128 6/2/2025
1.0.13 134 6/2/2025
1.0.12 131 6/2/2025
1.0.11 60 5/31/2025
1.0.10 61 5/31/2025
1.0.9 56 5/31/2025
1.0.8 68 5/31/2025
1.0.7 59 5/31/2025
1.0.6 54 5/31/2025
1.0.5 57 5/31/2025
1.0.4 60 5/31/2025
1.0.3 60 5/31/2025
1.0.3-pre.1 39 5/30/2025
1.0.2 100 5/30/2025

## v1.0.19 (patch)

Changes since v1.0.18:

- Enhance error handling in changelog generation ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.18 (patch)

Changes since v1.0.17:

- Enhance error handling in PSBuild.psm1 for changelog generation ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.17 (patch)

Changes since v1.0.16:

- Enhance error handling in PSBuild.psm1 and update derived cursor rules ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.16 (patch)

Changes since v1.0.15:

- Enhance build script to respect release flags for package publishing and GitHub releases ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.15 (patch)

Changes since v1.0.14:

- Fix build errors and improve code quality ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor command line handling to use CommandLineParser library ([@matt-edmondson](https://github.com/matt-edmondson))
- Split classes into their own files and convert to records ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance derived cursor rules and update test structures ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.14 (patch)

Changes since v1.0.13:

- Update YAML schema references in Winget manifests for consistency ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.13 (patch)

Changes since v1.0.12:

- Add YAML schema references to Winget manifests ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.12 (patch)

Changes since v1.0.11:

- Update Winget manifests to version 1.10.0 and add .NET Desktop Runtime dependency ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.11 (patch)

Changes since v1.0.10:

- Fix winget installer executable name in manifests and update PowerShell script for future compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.10 (patch)

Changes since v1.0.9:

- Add GitHub token to Winget manifests update step ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.9 (patch)

Changes since v1.0.8:

- Add release upload command for Winget manifests ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.8 (patch)

Changes since v1.0.7:

- Adjust publishing settings in Invoke-DotNetPublish function by disabling trimming for output files. This change aims to improve compatibility for self-contained applications. ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.7 (patch)

Changes since v1.0.6:

- Optimize publishing settings in Invoke-DotNetPublish function by enabling trimming for smaller output files. This change enhances the build process for self-contained applications. ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.6 (patch)

Changes since v1.0.5:

- Update SDK versions in global.json to 1.38.0 ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.5 (patch)

Changes since v1.0.4:

- Fix issue trying to submit release twice ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.4 (patch)

Changes since v1.0.3:

- Update ktsu SDK versions in global.json from 1.35.0 to 1.36.0 for all components. ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.3 (patch)

Changes since v1.0.2:

- Prepare BlastMerge for winget distribution by enhancing project configuration, consolidating publish functionality, and integrating winget manifest updates. Update the `Invoke-DotNetPublish` function to streamline publishing for all platforms and architectures, ensuring SHA256 hashes are generated for integrity verification. Create scripts for automating winget manifest updates and include necessary files for distribution. ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.3-pre.1 (prerelease)

Incremental prerelease update.
## v1.0.2 (patch)

Changes since v1.0.1:

- Rename to BlastMerge ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.1 (patch)

Changes since v1.0.0:

- Refactor test suite to utilize Testable.IO.Abstractions for improved file access testing ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor tests to utilize mock file system and improve file handling ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.0 (major)

- Refactor choice handling in CLI to use Contains method for user input ([@matt-edmondson](https://github.com/matt-edmondson))
- Update documentation and enhance primary feature focus for cross-repository synchronization ([@matt-edmondson](https://github.com/matt-edmondson))
- Add cursor ignore file and update runsettings for parallel test execution ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement error handling for concurrent interactive functions in Spectre.Console ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor diffing functionality to fully integrate LibGit2Sharp ([@matt-edmondson](https://github.com/matt-edmondson))
- Integrate LibGit2Sharp for enhanced diffing functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove redundant standalone test files and cleanup ([@matt-edmondson](https://github.com/matt-edmondson))
- Add debug test files and enhance FileDiffer functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Initial commit for DiffMore ([@matt-edmondson](https://github.com/matt-edmondson))
- Add LibGit2Sharp integration documentation and tests ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor FileDiffer logic and enhance debug test output ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor test files to remove unnecessary using directives and enhance empty file handling in diff algorithm ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance interactive merge display to show context for conflicts ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance debug test and FileDiffer functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor conflict display in iterative merge mode to reduce excessive blank lines ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix null reference warnings and improve test file structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor input handling to improve command history functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Add missing cases suppression for ProcessSpecialKey method ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor MakeConflictColumnLayout for improved clarity and performance ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix test implementations and enhance static class usage ([@matt-edmondson](https://github.com/matt-edmondson))
- Replace LibGit2Sharp with DiffPlex for enhanced diffing functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Initial version ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor FileDiffer and update test files for improved compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance iterative merge process and improve diff display functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance debug test and implement TUI for DiffMore CLI ([@matt-edmondson](https://github.com/matt-edmondson))
- Update derived cursor rules and refine CLI input handling ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement manual block selection for merge conflicts ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor test project to resolve package conflicts and enhance mock filesystem compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor input handling and improve code quality ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove obsolete test files and sample application from the DiffMore project, including test1.txt, test2.txt, and related scripts. ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor test implementations and enhance static class usage ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement command history functionality in DiffMore CLI ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor diffing logic and improve test coverage for core library ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance iterative merge functionality and improve user interface ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance LibGit2Sharp integration for improved diffing functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Update derived cursor rules documentation and address unnecessary using directives ([@matt-edmondson](https://github.com/matt-edmondson))
- Add directory comparison functionality and enhance test helper methods ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix prologue context display in side-by-side diffs ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance derived cursor rules and update FileDiffer logic ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement iterative merge feature for multiple file versions ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance interactive merge functionality to display conflicts side by side ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance derived cursor rules documentation and add directory comparison guidelines ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance exception handling in test cleanup and update collection types ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor conflict resolution display and update editorconfig settings ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor diffing functionality to integrate LibGit2Sharp and enhance performance ([@matt-edmondson](https://github.com/matt-edmondson))
- Update Directory.Build.props and refine CLI input handling ([@matt-edmondson](https://github.com/matt-edmondson))
- Add SpecStory configuration and enhance project structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance error handling and improve interactive function management ([@matt-edmondson](https://github.com/matt-edmondson))
- Update test project dependencies and refactor test classes for mock filesystem compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove project reference to DiffMore.Core in CLI project ([@matt-edmondson](https://github.com/matt-edmondson))