Improve changesets

Author: mayank1513

.changeset/cuddly-pens-guess.md

@@ -2,7 +2,31 @@
 "git-json-resolver": major
 ---
 
-⚠️ **Breaking change**: Arrays are no longer merged element-by-element under the default `merge` strategy.  
-Only **plain objects** are merged by default. Arrays must now be handled with explicit strategies (e.g. `concat`, `unique`, or custom).
+# 🚨 Breaking Change: Array Merge Strategy
 
-This change avoids unpredictable results when merging arrays of different lengths or semantics, making merging more predictable and safe.
+**Arrays are no longer merged element-by-element** under the default `merge` strategy.
+
+## What Changed
+- Only **plain objects** are merged by default
+- Arrays now require explicit strategies: `concat`, `unique`, or custom resolvers
+
+## Why This Change
+Previous array merging was unpredictable when arrays had:
+- Different lengths
+- Different semantic meanings
+- Mixed data types
+
+## Migration Guide
+```ts
+// Before (automatic array merging)
+rules: [{ pattern: "*", strategy: "merge" }]
+
+// After (explicit array handling)
+rules: [
+  { pattern: "dependencies", strategy: "concat" },
+  { pattern: "scripts", strategy: "ours" },
+  { pattern: "*", strategy: "merge" } // objects only
+]
+```
+
+This ensures **predictable and safe** conflict resolution.

.changeset/green-falcons-fly.md

@@ -2,4 +2,14 @@
 "git-json-resolver": patch
 ---
 
-Refactor: Simplify normalizer. Move file handling logic to utils.
+# 🔧 Code Refactoring
+
+## Normalizer Simplification
+- **Streamlined normalizer logic** for better maintainability
+- **Moved file handling utilities** to dedicated utils module
+- **Improved separation of concerns** between components
+
+## Benefits
+- Cleaner, more focused code structure
+- Enhanced testability and debugging
+- Better code reusability across modules

.changeset/quick-buses-decide.md

@@ -2,4 +2,23 @@
 "git-json-resolver": minor
 ---
 
-Backup path is now configurable
+# 📁 Configurable Backup Path
+
+## New Feature
+**Backup file location is now fully configurable** for enhanced flexibility.
+
+## Usage
+```ts
+import { resolveConflicts } from "git-json-resolver";
+
+resolveConflicts({
+  filePath: "package.json",
+  backupPath: "./backups/package.json.backup", // Custom backup location
+  rules: [/* your rules */]
+});
+```
+
+## Benefits
+- **Custom backup directories** for better organization
+- **Integration with existing backup strategies**
+- **Compliance with project structure requirements**

.changeset/restore-command.md

@@ -2,4 +2,25 @@
 "git-json-resolver": minor
 ---
 
-Add CLI restore command to restore backup files
+# 🔄 CLI Restore Command
+
+## New CLI Feature
+**Restore backup files** with a dedicated command for quick recovery.
+
+## Usage
+```bash
+# Restore specific backup
+npx git-json-resolver restore package.json.backup
+
+# Restore all backups in directory
+npx git-json-resolver restore --all
+
+# Restore with confirmation prompt
+npx git-json-resolver restore --interactive
+```
+
+## Benefits
+- **Quick recovery** from failed merges
+- **Batch restore operations** for multiple files
+- **Interactive mode** for safer restoration
+- **Seamless CI/CD integration** for rollback scenarios

.changeset/social-rats-look.md

@@ -2,4 +2,28 @@
 "git-json-resolver": minor
 ---
 
-Support pattern nagation with ! for the default basicMatcher.
+# ⚡ Pattern Negation Support
+
+## New Matcher Feature
+**Pattern negation with `!` prefix** for the default `basicMatcher`.
+
+## Usage
+```ts
+import { resolveConflicts } from "git-json-resolver";
+
+resolveConflicts({
+  filePath: "package.json",
+  rules: [
+    { pattern: "dependencies.*", strategy: "ours" },
+    { pattern: "!dependencies.react", strategy: "theirs" }, // Negation
+    { pattern: "scripts.*", strategy: "merge" },
+    { pattern: "!scripts.test", strategy: "manual" } // Exception
+  ]
+});
+```
+
+## Benefits
+- **Fine-grained control** over merge strategies
+- **Exception handling** within broader patterns
+- **Intuitive syntax** familiar from gitignore patterns
+- **Enhanced rule flexibility** for complex scenarios

.changeset/warm-rocks-clap.md

@@ -2,4 +2,24 @@
 "git-json-resolver": patch
 ---
 
-Improve error handling and unit tests. Add performance enhancemnts
+# 🚀 Quality & Performance Improvements
+
+## Enhanced Error Handling
+- **More descriptive error messages** with context
+- **Graceful fallbacks** for edge cases
+- **Better error recovery** mechanisms
+
+## Expanded Test Coverage
+- **Additional unit tests** for critical paths
+- **Edge case validation** scenarios
+- **Performance regression tests**
+
+## Performance Enhancements
+- **Optimized pattern matching** algorithms
+- **Reduced memory footprint** for large files
+- **Faster conflict resolution** processing
+
+## Benefits
+- More reliable conflict resolution
+- Better debugging experience
+- Improved performance for large repositories