Updating readme and claude files

Author: lookbusy1344

CLAUDE.md

@@ -28,7 +28,7 @@ dotnet test
 dotnet test --logger:"console;verbosity=detailed"
 
 # Run a specific test class
-dotnet test --filter "FullyQualifiedName~StringPoolTest"
+dotnet test --filter "FullyQualifiedName~UnmanagedStringPoolTests"
 
 # Run a specific test method
 dotnet test --filter "FullyQualifiedName~TestClassName.TestMethodName"
@@ -47,6 +47,9 @@ dotnet build --no-incremental
 
 # Format code after making changes
 dotnet format
+
+# Verify code is properly formatted without making changes
+dotnet format --verify-no-changes
 ```
 
 **IMPORTANT**: Always run `dotnet format` after making any code changes to ensure consistent formatting.

Demo/README.md

@@ -0,0 +1,83 @@
+# UnmanagedStringPool Demo
+
+This directory contains a demonstration application showing practical usage of the UnmanagedStringPool library.
+
+## Overview
+
+The demo application (`Demo.cs`) provides a hands-on example of:
+- Creating and managing a string pool
+- Allocating and freeing strings
+- String manipulation operations
+- Pool memory statistics and fragmentation monitoring
+- Pool growth and defragmentation
+
+## Running the Demo
+
+```bash
+# From the Demo directory
+dotnet run
+
+# Or from the project root
+dotnet run --project Demo/StringPoolDemo.csproj
+```
+
+## Demo Features
+
+### Basic Operations
+- String allocation from the pool
+- Value semantics demonstration (struct equality)
+- String freeing and memory reuse
+- Using statement integration with disposable strings
+
+### String Manipulation
+- String insertion operations
+- Replacement and trimming
+- Substring extraction
+- Case conversion
+
+### Memory Management
+- Real-time fragmentation monitoring
+- Free space tracking
+- Active allocation counting
+- Forced defragmentation and pool growth
+
+### Performance Comparison
+- Timing comparisons between pooled and regular strings
+- Memory allocation stress testing
+- GC pressure demonstration
+
+## Sample Output
+
+```
+Value semantics, does Hello == Hello? False
+Hello
+World
+This is a longer string
+Free space before: 3968
+End block space: 3968
+Active allocations: 4
+Fragmentation: 0.00%
+...
+After pool growth:
+Free space after: 8064
+End block space: 8064
+Active allocations: 4
+Fragmentation: 0.00%
+```
+
+## Key Learning Points
+
+1. **Struct Semantics**: PooledString instances are value types with reference equality semantics
+2. **Memory Efficiency**: See how freed memory is immediately reused
+3. **Fragmentation**: Observe fragmentation patterns and defragmentation in action
+4. **Growth**: Watch the pool automatically grow when needed
+5. **Disposal**: Proper resource cleanup with using statements
+
+## Customization
+
+Modify the demo to experiment with:
+- Different initial pool sizes
+- Various string allocation patterns
+- Concurrent access scenarios (with proper synchronization)
+- Large-scale string operations
+- Custom fragmentation thresholds

README.md

@@ -89,6 +89,21 @@ str1.Dispose();
 // Pool automatically cleans up remaining allocations on disposal
 ```
 
+## Test Suite
+
+The project includes comprehensive test coverage across multiple areas:
+
+- **UnmanagedStringPoolTests.cs**: Core functionality and basic operations
+- **UnmanagedStringPoolEdgeCaseTests.cs**: Edge cases and error conditions
+- **FragmentationAndMemoryTests.cs**: Memory management and defragmentation
+- **FragmentationTest.cs**: Specific fragmentation scenarios
+- **PooledStringTests.cs**: String operations and manipulations
+- **ConcurrentAccessTests.cs**: Thread safety and concurrent operations
+- **DisposalAndLifecycleTests.cs**: Object disposal and lifecycle management
+- **FinalizerBehaviorTests.cs**: Finalizer and GC interaction tests
+- **ClearMethodTests.cs**: Pool clearing operations
+- **IntegerOverflowTests.cs**: Overflow protection and boundary conditions
+
 ## Performance Characteristics
 
 - **Allocation**: O(1) average case with size-indexed free lists
@@ -114,6 +129,12 @@ dotnet test
 
 # Run with detailed output
 dotnet test --logger:"console;verbosity=detailed"
+
+# Run specific test class
+dotnet test --filter "FullyQualifiedName~UnmanagedStringPoolTests"
+
+# Format code (important after making changes)
+dotnet format
 ```
 
 For detailed information about the test suite and coverage areas, see [Tests/README.md](Tests/README.md).

Tests/README.md

@@ -32,6 +32,12 @@ This directory contains comprehensive tests for the UnmanagedStringPool implemen
 - Memory efficiency validation
 - Stress testing with interleaved operations
 
+**`FragmentationTest.cs`** - *Specific fragmentation scenario testing*
+- Focused fragmentation pattern creation
+- Fragmentation percentage calculation validation
+- Defragmentation trigger testing
+- Memory compaction verification
+
 **`FinalizerBehaviorTests.cs`** - *Unmanaged resource cleanup and finalizer execution*
 - Finalizer execution without explicit disposal
 - Memory leak prevention validation