ci: add GitHub Actions workflow and update README

Author: madhugilla

.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  build-test:
+    runs-on: windows-latest
+    env:
+      DOTNET_NOLOGO: true
+      DOTNET_CLI_TELEMETRY_OPTOUT: 1
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            8.0.x
+
+      - name: Restore dependencies
+        run: dotnet restore
+
+      - name: Cache NuGet packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Build
+        run: dotnet build --configuration Release --no-restore
+
+      - name: Run tests with coverage
+        run: dotnet test --configuration Release --no-build --collect "XPlat Code Coverage" --results-directory TestResults
+
+      - name: Convert coverage to lcov
+        run: |
+          dotnet tool install --global dotnet-reportgenerator-globaltool --version 5.*
+          reportgenerator -reports:TestResults/**/coverage.cobertura.xml -targetdir:coverage -reporttypes:lcov
+        env:
+          PATH: $env:PATH:~/.dotnet/tools
+
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: TestResults
+
+  lint-readme:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Markdown lint
+        uses: avto-dev/markdown-lint@v1
+        with:
+          args: README.md

README.md

@@ -323,15 +323,17 @@ Do not commit real credentials. Connection string is externalized. Recommended i
 
 ## 🤖 CI/CD (Suggested)
 
-Add a GitHub Actions workflow `.github/workflows/ci.yml`:
+Workflow defined in `.github/workflows/ci.yml` executes on pushes and PRs to `main` or `master`:
 
-- Restore -> Build (Release) -> Test -> (Optional) Publish test & coverage results
-- Fail build on test failures
+- Restore -> Build (Release) -> Test (with coverage collection)
+- Publishes test results & coverage (Cobertura + lcov) as artifacts
+- Separate job lints `README.md` using markdown-lint
 
-Optional steps:
+You can extend by:
 
-- Cache NuGet (`actions/cache`)
-- Upload coverage to Codecov
+- Adding Codecov upload (needs CODECOV_TOKEN secret)
+- Enabling dependabot for NuGet & GitHub Actions
+- Adding security scanning (CodeQL workflow)
 
 ## 🗺️ Roadmap (Ideas)