ObliviOS Developer portal Project site

Home / Decisions / ADR-214

Amend ADR-208 and section 4.2 of docs/superpowers/specs/2026-10-30-compartments-profiles-design.md.

Proposed, recorded 3 November 2026.

Decision
ADR-214
Date
2026-11-03
Status
ProposedProposed (owner's requirement 2026-11-03; design in section 4.2.1 of the profiles design, plan docs/superpowers/plans/2026-11-03-standing-location-fix.md, patch frameworks-base/0027 authored and host-checked 2026-11-03 and landed on the build tree 2026-11-03 as f97327ea7c7b (454 of 454 mutants killed, type check as the unchanged tree); frameworks-base/0028 (a32e09ce65a6, native review before the build: onStandingAlarm left the time of the last standing fix alone when an emergency held a due fix back, so standingDelayMs stayed at zero or less and a wakeup alarm of 1 ms was set again and again, each time asking telephony; the time is now set whenever a fix is due, made or not; read in source only, not compiled); not built, not on a device; the fix quality is a model, not compared with real fixes)
Mentions
ADR-037, ADR-208

1Decision

Amend ADR-208 and section 4.2 of docs/superpowers/specs/2026-10-30-compartments-profiles-design.md: an app with Location on Substitute data and a place gets a standing fix at that place while no real fix arrives, so exact location works indoors. The real fix, when there is one, is still translated by the per-app vector; the standing fix is a second source for the same registration, not a mock provider.

2Why and evidence

Owner 2026-11-03 (chat): Maps with a place far away finds no location and cannot route; exact location must work and an app must never notice a fake location. Cause [measured: lynx 2026110203, dumpsys location]: no real source indoors (GnssService 0 locations in 16 h, network 0) and the hooks act only on delivery, so a persona app gets nothing; with a mock source the same app got the persona place (CMP-047).

Direction [design, not built]: a per-registration producer in LocationProviderManager for a persona app delivers a fix at the place at the requested interval when no real fix arrived within a few seconds, with accuracy, time and elapsed time like a real fix, a stationary phone's speed, no mock flag and no altitude; the vector of PersonaTrack is anchored at the first real fix as now, so a real fix that returns continues from the standing position without a jump larger than its accuracy; getLastLocation answers with the same fix.

Rejected: enabling the network location backend (it sends Wi-Fi and cell data to a third party, against the no-telemetry rule); a mock provider (apps can read isMock and the provider list); one frozen point (a known tell, section 4.2).

3Consequences

A persona app on a phone with no GNSS fix learns a position at the place, which is what a traveller outdoors would give; it still gets no GNSS status or NMEA (section 4.5). The fix quality (jitter, accuracy distribution) is a choice that needs measuring against real outdoor fixes before it is called indistinguishable. Touches frameworks/base location code: held to the higher bar for privileged code.

Checked against the source on 2026-11-03: the direction holds with four refinements [verified-in-source: LocationProviderManager at frameworks/base 10000dab31e8]. The standing fix is kept per app in PersonaTrack and never written to the shared last-location table of a provider, which holds real fixes for every app.

A standing fix is already at the place, so the delivery skips the translation, and the distance filter of a request ignores the distance between a real and a standing fix. The emergency state is read outside the lock of the multiplexer (a telephony call), and an emergency gets no standing fix. A real fix at 1.5 m/s or more holds the standing fix back for 120 s, so that a tunnel is a gap and not a stop [assumption].

The prior art is the Location Anchor design (ADR-037, never implemented), whose noise model the fix reuses.

4Review when

Accepted when CMP-047 passes on a device with no GNSS fix and the same app on the same place shows no discontinuity when a real fix returns; reopen if an app can tell the fix from a real one.

Read from docs/governance/decision-log.md, entry ADR-214.