Improve user README and fix release lint for listener service

Author: celestialtaha

README.md

@@ -1,49 +1,62 @@
-# Wessage
+# Wessage (Wear OS Companion)
 
-Wear OS messaging app focused on fast glance-and-reply workflows with a modern glass style.
+Wessage is a modern, minimal Wear OS messaging companion focused on:
 
-## Stack
+- fast glance + reply on watch
+- clean glass-style UI
+- local-first sync with your phone app
 
-- Kotlin `2.2.10`
-- AGP `9.1.0`
-- Wear Compose Foundation `1.5.6`
-- Wear Compose Material 3 `1.5.6`
-- Compile SDK `36`, min SDK `29`
+## For Most Users
 
-## Architecture Notes
+Download from the **Releases** page:
 
-- Wear-native scaffolding: `AppScaffold -> ScreenScaffold -> ScalingLazyColumn`
-- Swipe-back navigation with `BasicSwipeToDismissBox`
-- Single source of truth in `MessagingViewModel` with `StateFlow`
-- Lifecycle-aware state collection via `collectAsStateWithLifecycle()`
+- https://github.com/celestialtaha/Wessage/releases
 
-## Releases (Maintainers)
+Install the latest watch APK, open the app once, and keep Bluetooth enabled.
 
-Releases are generated from tags matching `v*` (for example `v1.1.0`) via GitHub Actions.
+## What You Need
 
-Typical assets:
+- Android phone with the companion phone app installed
+- A Wear OS watch paired to that phone
+- Bluetooth enabled on both devices
 
-- `app-debug.apk`
-- `app-release-signed.apk` (when signing secrets are configured)
-- `app-release-unsigned.apk` (fallback)
-- `SHA256SUMS.txt`
+Internet is not required for normal phone-watch message sync once pairing is active.
+
+## Setup in 2 Minutes
+
+1. Install the latest phone app release (from `celestialtaha/Messages`).
+2. Install the latest watch app release from this repo.
+3. Open the phone app, then open Wessage on the watch.
+4. Grant permissions on phone/watch when prompted.
+5. Wait a few seconds for initial thread sync.
+
+## Privacy
+
+- No separate cloud account is required.
+- Sync is phone <-> watch over Wear OS data layer.
+- Data is not sent to third-party servers by this app for core sync.
 
-Release flow:
+## Troubleshooting
 
-1. Bump version in `app/build.gradle.kts`.
-2. Push changes to `main`.
-3. Tag and push:
+- No messages on watch:
+  - Open both apps once (phone first, then watch).
+  - Confirm watch is paired and connected.
+  - Keep Bluetooth on.
+- Slow first sync:
+  - Initial sync can take longer than incremental updates.
+
+## Maintainers: Release Process
+
+Tag any commit with `v*` (example `v1.0.0`) to trigger release workflow:
 
 ```bash
-git tag v1.1.0
-git push origin v1.1.0
+git tag v1.0.0
+git push origin v1.0.0
 ```
 
-4. Workflow creates a GitHub Release and uploads APK assets.
-
-### Optional Signing Secrets
+Workflow outputs:
 
-- `ANDROID_SIGNING_KEY_BASE64`
-- `ANDROID_ALIAS`
-- `ANDROID_KEYSTORE_PASSWORD`
-- `ANDROID_KEY_PASSWORD`
+- `app-debug.apk`
+- `app-release-signed.apk` (if secrets exist)
+- `app-release-unsigned.apk` (fallback)
+- `SHA256SUMS.txt`

app/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <uses-feature android:name="android.hardware.type.watch" />
 
@@ -44,7 +45,9 @@
             android:name=".sync.WearSyncListenerService"
             android:exported="true">
             <intent-filter>
-                <action android:name="com.google.android.gms.wearable.BIND_LISTENER" />
+                <action
+                    android:name="com.google.android.gms.wearable.BIND_LISTENER"
+                    tools:ignore="WearableBindListener" />
             </intent-filter>
         </service>