Refactor/improve code (#5)

* docs: update FaultyDataSource documentation for clarity and accuracy

* refactor: improve diagnostics and data source handling; refactor: update range chunk and intent structures; chore: add new test infrastructure project

* refactor: improve thread safety and synchronization in CopyOnReadStorage; enhance documentation for clarity

* refactor: update documentation to reflect changes in cache state management

* refactor: revise ICacheDiagnostics interface to focus on key events

* refactor: improve user request handling logic for cache scenarios and enhance documentation

* refactor: improve code structure and remove redundant elements;
refactor: enhance clarity in comments and documentation;
chore: exclude benchmark project from code coverage

* refactor: update method signatures and improve data handling in various classes;
feat: introduce new diagnostics tests for NoOpDiagnostics;
fix: correct range handling in tests and documentation;
chore: remove redundant test data source and simplify test infrastructure;
style: enhance code readability and consistency across files

* docs: README and documentation files have been updated for clarity and accuracy;
style: formatting improvements have been made to tables and lists;
refactor: redundant references in documentation have been removed

* chore: update documentation links and structure in various markdown files;
refactor: enhance .gitignore for IDE and OS-specific files;
docs: add public API and user path documentation

* test: unit tests for cache data extension service and async activity counter have been added;
test: rebalance failure handling and disposal scenarios have been validated;
test: execution request lifecycle behavior has been verified

* style: code formatting has been improved in NoRebalanceRangePlanner and UserRequestHandler

* docs: README file has been updated to include current performance baselines and benchmark reports;
refactor: benchmark reports have been reorganized for clarity and consistency;
style: formatting improvements made to benchmark sections for better readability

* Update docs/components/rebalance-path.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* refactor: improve diagnostics and data handling in IDataSource and RangeChunk

* refactor: update user-path documentation for improved clarity and accuracy

* refactor: improve documentation for CopyOnReadStorage and clarify locking behavior;
refactor: enhance ToRangeData method to ensure immutable snapshot is returned;
refactor: update invariants and summaries for better clarity on storage strategies

* Update docs/components/public-api.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update docs/components/public-api.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update docs/components/intent-management.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* refactor(execution): improve execution controller structure and semantics;
refactor(intent-management): enhance intent management logic for clarity;
refactor(state): update state management to reflect storage changes;
refactor(api): adjust public API documentation for consistency

---------

Co-authored-by: Mykyta Zotov <mykyta.zotov@ihsmarkit.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.gitignore

@@ -2,4 +2,12 @@ bin/
 obj/
 /packages/
 riderModule.iml
-/_ReSharper.Caches/
+/_ReSharper.Caches/
+
+# IDE / user-specific
+.idea/
+.vs/
+*.DotSettings.user
+
+# Stray / OS artifacts
+nul

AGENTS.md

@@ -132,7 +132,7 @@ using Intervals.NET;
 using Intervals.NET.Domain.Abstractions;
 using SlidingWindowCache.Core.Planning;
 using SlidingWindowCache.Core.State;
-using SlidingWindowCache.Infrastructure.Instrumentation;
+using SlidingWindowCache.Public.Instrumentation;
 ```
 
 ### XML Documentation
@@ -207,7 +207,7 @@ catch (Exception ex)
 ### Concurrency Patterns
 
 **Single-Writer Architecture (CRITICAL):**
-- User Path: READ-ONLY (never mutates Cache, LastRequested, or NoRebalanceRange)
+- User Path: READ-ONLY (never mutates Cache, IsInitialized, or NoRebalanceRange)
 - Rebalance Execution: SINGLE WRITER (sole authority for cache mutations)
 - Serialization: Channel-based with single reader/single writer (intent processing loop)
 
@@ -305,29 +305,32 @@ refactor: AsyncActivityCounter lock has been removed and replaced with lock-free
 - Documentation may be outdated; long-term goal is synchronization with code
 
 ### Documentation Update Map
-| File | Update When | Focus |
-|------|-------------|-------|
-| `README.md` | Public API changes, new features | User-facing examples, configuration |
-| `docs/invariants.md` | Architectural invariants changed | System constraints, concurrency rules |
-| `docs/architecture-model.md` | Concurrency mechanisms changed | Thread safety, synchronization primitives |
-| `docs/component-map.md` | New components, major refactoring | Component catalog, dependencies |
-| `docs/actors-and-responsibilities.md` | Component responsibilities changed | Actor roles, explicit responsibilities |
-| `docs/cache-state-machine.md` | State transitions changed | State machine specification |
-| `docs/storage-strategies.md` | Storage implementation changed | Strategy comparison, performance |
-| `docs/scenario-model.md` | Temporal behavior changed | Scenario walkthroughs, sequences |
-| `docs/diagnostics.md` | New diagnostics events | Instrumentation guide |
-| `benchmarks/*/README.md` | Benchmark changes | Performance methodology, results |
-| `tests/*/README.md` | Test architecture changes | Test suite documentation |
-| XML comments (in code) | All code changes | Component purpose, invariant references |
+
+| File                          | Update When                        | Focus                                   |
+|-------------------------------|------------------------------------|-----------------------------------------|
+| `README.md`                   | Public API changes, new features   | User-facing examples, configuration     |
+| `docs/invariants.md`          | Architectural invariants changed   | System constraints, concurrency rules   |
+| `docs/architecture.md`        | Concurrency mechanisms changed     | Thread safety, coordination model       |
+| `docs/components/overview.md` | New components, major refactoring  | Component catalog, dependencies         |
+| `docs/actors.md`              | Component responsibilities changed | Actor roles, explicit responsibilities  |
+| `docs/state-machine.md`       | State transitions changed          | State machine specification             |
+| `docs/storage-strategies.md`  | Storage implementation changed     | Strategy comparison, performance        |
+| `docs/scenarios.md`           | Temporal behavior changed          | Scenario walkthroughs, sequences        |
+| `docs/diagnostics.md`         | New diagnostics events             | Instrumentation guide                   |
+| `docs/glossary.md`            | Terms or semantics change          | Canonical terminology                   |
+| `benchmarks/*/README.md`      | Benchmark changes                  | Performance methodology, results        |
+| `tests/*/README.md`           | Test architecture changes          | Test suite documentation                |
+| XML comments (in code)        | All code changes                   | Component purpose, invariant references |
 
 ## Architecture References
 
 **Before making changes, consult these critical documents:**
-- `docs/invariants.md` - System invariants (33KB) - READ THIS FIRST
-- `docs/architecture-model.md` - Architecture and concurrency model
-- `docs/actors-and-responsibilities.md` - Component responsibilities
-- `docs/component-map.md` - Detailed component catalog (86KB)
-- `README.md` - User guide and examples (32KB)
+- `docs/invariants.md` - System invariants - READ THIS FIRST
+- `docs/architecture.md` - Architecture and concurrency model
+- `docs/actors.md` - Actor responsibilities and boundaries
+- `docs/components/overview.md` - Component catalog (split by subsystem)
+- `docs/glossary.md` - Canonical terminology
+- `README.md` - User guide and examples
 
 **Key Invariants to NEVER violate:**
 1. Cache Contiguity: No gaps allowed in cached ranges
@@ -342,6 +345,7 @@ refactor: AsyncActivityCounter lock has been removed and replaced with lock-free
 - `src/SlidingWindowCache/Public/WindowCache.cs` - Main cache facade
 - `src/SlidingWindowCache/Public/IDataSource.cs` - Data source contract
 - `src/SlidingWindowCache/Public/Configuration/` - Configuration classes
+- `src/SlidingWindowCache/Public/Instrumentation/` - Diagnostics
 
 **Core Logic:**
 - `src/SlidingWindowCache/Core/UserPath/` - User request handling (read-only)
@@ -351,7 +355,6 @@ refactor: AsyncActivityCounter lock has been removed and replaced with lock-free
 
 **Infrastructure:**
 - `src/SlidingWindowCache/Infrastructure/Storage/` - Storage strategies
-- `src/SlidingWindowCache/Infrastructure/Instrumentation/` - Diagnostics
 - `src/SlidingWindowCache/Infrastructure/Concurrency/` - Async coordination
 
 ## CI/CD