release: SourceFlow.Net v2.0.0 - AWS Cloud Integration & CI Improvements

Major release with AWS cloud integration, CI/CD enhancements, and comprehensive testing improvements.

## AWS Cloud Integration
- Add AWS SQS/SNS integration for distributed command and event processing
- Implement LocalStack support for local AWS service emulation
- Add comprehensive AWS integration tests with property-based testing
- Fix LocalStack connectivity and authentication in CI environments
- Add external LocalStack detection to prevent container conflicts

## CI/CD Improvements
- Configure LocalStack as GitHub Actions service for integration tests
- Add NuGet cache clearing to prevent stale package metadata issues
- Exclude integration and security tests from CI (run unit tests only)
- Add comprehensive GitHub Actions setup documentation
- Fix GitVersion configuration for release branches
- Update workflows with paths-ignore for documentation changes

## Testing Enhancements
- Add LocalStack timeout and connectivity diagnostics
- Implement property-based tests for AWS service equivalence
- Add dead letter queue processing tests
- Fix SQS queue attribute names and DLQ test timing
- Add CI-optimized LocalStack configuration with extended timeouts

## Documentation
- Add GitHub Actions setup guide with troubleshooting
- Update cloud integration testing documentation
- Add AWS cloud architecture documentation
- Update README with new logo images

## Bug Fixes
- Fix .NET Standard 2.1 compatibility with GlobalUsings.cs
- Fix AWS client endpoint configuration for LocalStack
- Fix IAM enforcement in LocalStack service container
- Fix compilation errors in AwsTestConfiguration

## Breaking Changes
- Cloud.Core functionality consolidated into main SourceFlow package (v2.0.0)
- Namespace changes: SourceFlow.Cloud.Core.* → SourceFlow.Cloud.*

Related specs:
- .kiro/specs/v2-0-0-release-preparation/
- .kiro/specs/github-actions-localstack-timeout-fix/
- .kiro/specs/github-actions-ci-configuration-fix/

Author: NinjaRocks

.github/workflows/Master-Build.yml

@@ -6,15 +6,57 @@ name: master-build
 on:
   push:
     branches: [ "master" ]
+        paths-ignore:
+        - "**/*.md"
+        - "**/*.gitignore"
+        - "**/*.gitattributes"  
 jobs:
   build:
     runs-on: ubuntu-latest
+    
+    services:
+      localstack:
+        image: localstack/localstack:latest
+        ports:
+          - 4566:4566
+        env:
+          SERVICES: sqs,sns,kms,iam
+          DEBUG: 1
+          DOCKER_HOST: unix:///var/run/docker.sock
+        options: >-
+          --health-cmd "curl -f http://localhost:4566/_localstack/health || exit 1"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 30
+          --health-start-period 30s
+    
     steps:
     - uses: actions/checkout@v3
     - name: Setup .NET
       uses: actions/setup-dotnet@v3
       with:
         dotnet-version: 9.0.x
+    
+    - name: Verify LocalStack is Ready
+      run: |
+        echo "Waiting for LocalStack to be fully ready..."
+        max_attempts=30
+        attempt=0
+        while [ $attempt -lt $max_attempts ]; do
+          if curl -f http://localhost:4566/_localstack/health 2>/dev/null; then
+            echo "LocalStack is ready!"
+            curl -s http://localhost:4566/_localstack/health | jq '.'
+            break
+          fi
+          attempt=$((attempt + 1))
+          echo "Attempt $attempt/$max_attempts - LocalStack not ready yet, waiting..."
+          sleep 3
+        done
+        if [ $attempt -eq $max_attempts ]; then
+          echo "ERROR: LocalStack did not become ready in time"
+          exit 1
+        fi
+    
     - name: Restore dependencies
       run: dotnet restore
     - name: Build
@@ -24,32 +66,6 @@ jobs:
     - name: Run Unit Tests
       run: dotnet test --no-build --verbosity normal --filter "Category=Unit"
 
-    # Start LocalStack container for integration tests
-    - name: Start LocalStack Container
-      run: |
-        docker run -d \
-          --name localstack \
-          -p 4566:4566 \
-          -e SERVICES=sqs,sns,kms,iam \
-          -e DEBUG=1 \
-          -e DOCKER_HOST=unix:///var/run/docker.sock \
-          localstack/localstack:latest
-        
-        # Wait for LocalStack to be ready (max 60 seconds)
-        echo "Waiting for LocalStack to be ready..."
-        timeout 60 bash -c 'until docker exec localstack curl -s http://localhost:4566/_localstack/health | grep -q "\"sqs\": \"available\""; do sleep 2; done' || echo "LocalStack startup timeout"
-        
-        # Display LocalStack health status
-        docker exec localstack curl -s http://localhost:4566/_localstack/health
-    
-    # Configure AWS SDK to use LocalStack endpoints
-    - name: Configure AWS SDK for LocalStack
-      run: |
-        echo "AWS_ACCESS_KEY_ID=test" >> $GITHUB_ENV
-        echo "AWS_SECRET_ACCESS_KEY=test" >> $GITHUB_ENV
-        echo "AWS_DEFAULT_REGION=us-east-1" >> $GITHUB_ENV
-        echo "AWS_ENDPOINT_URL=http://localhost:4566" >> $GITHUB_ENV
-    
     # Run integration tests against LocalStack
     - name: Run Integration Tests with LocalStack
       run: dotnet test --no-build --verbosity normal --filter "Category=Integration&Category=RequiresLocalStack"
@@ -58,13 +74,6 @@ jobs:
         AWS_SECRET_ACCESS_KEY: test
         AWS_DEFAULT_REGION: us-east-1
         AWS_ENDPOINT_URL: http://localhost:4566
-    
-    # Clean up LocalStack container
-    - name: Stop LocalStack Container
-      if: always()
-      run: |
-        docker stop localstack || true
-        docker rm localstack || true
 
   run-Lint:
       runs-on: ubuntu-latest