[Ambient] Android foreground service for BT/WiFi scan collection

Mark commented

2026-06-29 19:24:08 +00:00

Owner

Parent: #108

Problem

BT and WiFi scanning for ambient matching requires scanning while the app is not in the foreground. Android restricts background scanning; a foreground service is the standard mechanism.

Scope

Add a Capacitor plugin (or extend existing one) that runs a foreground service with an ongoing notification
Service wakes every N minutes, scans BT + WiFi, persists records to the Dexie tables added in #108
Auto-stops when the master "Ambient" toggle is off

Realities

Android 12+ requires explicit user consent + a visible foreground-service notification that can't be dismissed while running
Battery impact must be tested; if it's heavy, drop the interval

Out of scope

iOS (no equivalent API)
Cell-tower / passive GPS triangulation

## Parent: #108 ## Problem BT and WiFi scanning for ambient matching requires scanning while the app is not in the foreground. Android restricts background scanning; a foreground service is the standard mechanism. ## Scope - Add a Capacitor plugin (or extend existing one) that runs a foreground service with an ongoing notification - Service wakes every N minutes, scans BT + WiFi, persists records to the Dexie tables added in #108 - Auto-stops when the master "Ambient" toggle is off ## Realities - Android 12+ requires explicit user consent + a visible foreground-service notification that can't be dismissed while running - Battery impact must be tested; if it's heavy, drop the interval ## Out of scope - iOS (no equivalent API) - Cell-tower / passive GPS triangulation

Mark added the

feature-request

triage-approved

needs-decompose

labels

2026-06-29 19:24:08 +00:00

Mark commented

2026-06-29 20:38:06 +00:00

Author

Owner

Open design questions

Foreground service notification copy: Proposed: "Kin is listening for nearby devices so it can suggest logging an interaction. Tap to open the app."
Scan cadence: every 5 min, 15 min, or on-demand from a WorkManager periodic task? Proposed: WorkManager every 15 min.
Battery budget: no explicit cap; if drain shows up in QA, drop cadence. Confirm OK?

Needs answers before dispatch.

## Open design questions 1. Foreground service notification copy: Proposed: "Kin is listening for nearby devices so it can suggest logging an interaction. Tap to open the app." 2. Scan cadence: every 5 min, 15 min, or on-demand from a WorkManager periodic task? Proposed: WorkManager every 15 min. 3. Battery budget: no explicit cap; if drain shows up in QA, drop cadence. Confirm OK? Needs answers before dispatch.

Mark referenced this issue

2026-07-01 22:14:48 +00:00

[Ambient] Back-end: location, BT, WiFi, calendar ingest + suggestion engine #108

Mark referenced this issue

2026-07-02 07:10:53 +00:00

[Ambient] Foreground service (S1): Capacitor plugin skeleton: foreground service with persistent notification #134

Mark referenced this issue

2026-07-02 07:10:53 +00:00

[Ambient] Foreground service (S2): Periodic scanner at configurable interval; BT (BluetoothLeScanner) + WiFi (ScanResults) #135

Mark referenced this issue

2026-07-02 07:10:54 +00:00

[Ambient] Foreground service (S3): Persist records into the Dexie tables added by #108 (bluetoothProximityRecords, wifiNetworkRecords) #136

Mark referenced this issue

2026-07-02 07:10:54 +00:00

[Ambient] Foreground service (S4): Master-toggle gate: ambient off -> service auto-stops, notification removed #137

Mark referenced this issue

2026-07-02 07:10:54 +00:00

[Ambient] Foreground service (S5): Battery/benchmark validation per issue scope (drop interval if heavy); tests with mocked scanner #138

Mark removed the

needs-decompose

label

2026-07-02 07:10:54 +00:00

Mark commented

2026-07-02 07:10:54 +00:00

Author

Owner

Decomposed 2026-07-02 into 5 sub-issues. Parent stays as architectural record; needs-decompose removed since sub-issues now exist.

Mark added the

needs-decompose

label

2026-07-02 16:15:00 +00:00

Mark commented

2026-07-02 16:16:05 +00:00

Author

Owner

Auto-triage: needs decompose

Marked triage-approved + needs-decompose. decompose-executor will pick this up and break it into implementable sub-issues.

## Auto-triage: needs decompose Marked `triage-approved` + `needs-decompose`. decompose-executor will pick this up and break it into implementable sub-issues.

Mark commented

2026-07-03 14:45:37 +00:00

Author

Owner

Android foreground service parent — decomposed into #134 (S1), #135 (S2), #136 (S3), #137 (S4), #138 (S5). Closing parent; sub-issues tracked separately.