refactor!: rebuild SamsungHealthReporter on the Samsung Health Data SDK (#3)

## Summary
Rebuilds the library on the Samsung Health Data SDK 1.1.0 (the old
Samsung Health SDK for Android was deprecated on 31.07.2025) with the
HealthKitReporter architecture: one `SamsungHealthReporter` with a
reader, writer, observer and manager, library-owned types and
`@Serializable` payloads, suspend API, no SDK types in the public API.
Breaking: releases as 1.0.0.

## Changes
- `library/`: facade, services, 25 `HealthType`s, 20 `Aggregation`s, 15
sample payloads + `UserProfile`, 67 unit tests, `api/library.api`
- `samsung-health-data-stub/`: never-published stand-in for the
login-gated, non-redistributable SDK AAR
- `app/`: Jetpack Compose demo with a row per public call, plus
permission diagnostics
- Build: Gradle 8.14, AGP 8.13.2, Kotlin 2.2.21, ktlint, detekt, Kover,
binary-compatibility-validator; CI + release-please; CI fetches the real
AAR from the private `kvs-coder/samsung-health-sdk` repo with a
read-only deploy key
- Docs: `AGENTS.md` (+ `CLAUDE.md`), README with migration table,
CONTRIBUTING, ADRs 0001–0003, `ISSUE-*.md`
- Removed the 0.0.x sources, the 1.4.0 SDK jar and tracked `.idea/`

## Tests
- Unit tests: 67 executed, 0 failed, against the real SDK AAR and the
stub; coverage 98.3% (Kover gate 98)
- ktlint / detekt / Android lint: clean
- apiCheck: passes, `library.api` committed
- Example app build: passes; on a Pixel 7a (Samsung Health 7.00.6,
developer mode) all 25 read permissions are granted and device/profile
reads return real data; writes fail with SDK error 2003 until Samsung's
partnership access code is entered

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Author: kvs-coder

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+
+[*.{kt,kts}]
+max_line_length = 120
+ij_kotlin_allow_trailing_comma = true
+ij_kotlin_allow_trailing_comma_on_call_site = true
+ktlint_code_style = ktlint_official
+ktlint_standard_filename = disabled
+ktlint_standard_function-naming = disabled
+ktlint_function_naming_ignore_when_annotated_with = Composable
+
+[*.{yml,yaml,json,toml}]
+indent_size = 2

.github/pull_request_template.md

@@ -1,33 +1,13 @@
-## Status
-READY/IN DEVELOPMENT/HOLD
+## Summary
+<!-- BLUF: what changes and why, in one or two sentences. -->
 
-## Migrations
-YES | NO
+## Changes
+- `<file_path>`: <details>
 
-## Description
-A few sentences describing the overall goals of the pull request's commits.
+## Tests
+- Unit tests: <executed / failed>, coverage <percent>
+- ktlint / detekt / Android lint: clean
+- apiCheck: <passes | library.api regenerated>
+- Example app build: <passes | not applicable — no public API change>
 
-## Related PRs
-List related PRs against other branches:
-
-branch	PR
-other_pr_production	link
-other_pr_master	link
-Todos
- Tests
- Documentation
- 
-## Deploy Notes
-Notes regarding deployment the contained body of work. These should note any db migrations, etc.
-
-## Steps to Test or Reproduce
-Outline the steps to test or reproduce the PR here.
-
-git pull --prune
-git checkout <feature_branch>
-
-## Impacted Areas in Application
-Small description about what will be changed in the app if this PR will be merged
-
-## List general components of the application that this PR will affect:
-The direct changes inside the app made by this PR
+Refs: #<issue>

.github/workflows/ci.yml

@@ -0,0 +1,81 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [ master ]
+  push:
+    branches: [ master ]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  release-guard:
+    name: Version / Changelog
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: actions/checkout@v7
+      - name: Top CHANGELOG.md entry matches the release manifest
+        run: |
+          version=$(jq -r '."."' .release-please-manifest.json)
+          header=$(grep -m1 '^## ' CHANGELOG.md)
+          echo "manifest: $version, changelog: $header"
+          [[ "$header" =~ ^"## [$version] - "[0-9]{2}\.[0-9]{2}\.[0-9]{4}\.$ ]] || {
+            echo "::error file=CHANGELOG.md,line=1::Expected '## [$version] - dd.MM.yyyy.', got '$header'"
+            exit 1
+          }
+
+  build:
+    name: Lint, test, API check, build
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-java@v6
+        with:
+          distribution: corretto
+          java-version: 17
+      - uses: gradle/actions/setup-gradle@v6
+      # Samsung's license forbids redistributing the SDK, so the real AAR lives in the private repository
+      # kvs-coder/samsung-health-sdk, read with a read-only deploy key. Without the key (fork PRs), the build uses
+      # the samsung-health-data-stub module written from the SDK's API reference.
+      - name: Provide the Samsung Health Data SDK
+        env:
+          SAMSUNG_HEALTH_SDK_DEPLOY_KEY: ${{ secrets.SAMSUNG_HEALTH_SDK_DEPLOY_KEY }}
+        run: |
+          if [ -z "$SAMSUNG_HEALTH_SDK_DEPLOY_KEY" ]; then
+            echo "::warning::SAMSUNG_HEALTH_SDK_DEPLOY_KEY is not set; building against the SDK stub"
+            exit 0
+          fi
+          key="$RUNNER_TEMP/samsung-health-sdk-key"
+          printf '%s\n' "$SAMSUNG_HEALTH_SDK_DEPLOY_KEY" > "$key"
+          chmod 600 "$key"
+          GIT_SSH_COMMAND="ssh -i $key -o IdentitiesOnly=yes -o StrictHostKeyChecking=accept-new" \
+            git clone --depth 1 git@github.com:kvs-coder/samsung-health-sdk.git "$RUNNER_TEMP/samsung-health-sdk"
+          rm -f "$key"
+          mkdir -p library/libs
+          cp "$RUNNER_TEMP"/samsung-health-sdk/samsung-health-data-api-*.aar library/libs/
+          ls library/libs
+      - name: Lint
+        run: ./gradlew ktlintCheck detekt :library:lintDebug
+      - name: Test with coverage gate
+        run: ./gradlew :library:testDebugUnitTest :library:koverXmlReport :library:koverVerify
+      - name: Test against the SDK stub too, so it keeps matching the real SDK
+        if: hashFiles('library/libs/*.aar') != ''
+        run: ./gradlew :library:testDebugUnitTest -PsamsungHealthDataStub
+      - name: Public API check
+        run: ./gradlew :library:apiCheck
+      - name: Build library and example app
+        run: ./gradlew :library:assembleRelease :app:assembleDebug
+      - name: Upload reports
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: reports
+          path: |
+            library/build/reports
+            library/build/test-results
+          if-no-files-found: ignore

.github/workflows/release.yml

@@ -0,0 +1,18 @@
+name: Release
+
+on:
+  push:
+    branches: [ master ]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-26.04
+    steps:
+      - uses: googleapis/release-please-action@v5
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

.gitignore

@@ -87,3 +87,12 @@ lint/tmp/
 # Android Profiling
 *.hprof
 .idea/jarRepositories.xml
+
+# Samsung Health Data SDK: license forbids redistribution, add it locally (see README)
+library/libs/*.aar
+
+# IDE state
+.idea/
+
+# Local task notes, not for the repository
+ISSUE-*.md