## Navi v0.2.0-alpha

[Supermagnum]

First signed, tagged release. Previously the only distributable artifact was
a debug-cert APK checked into the repo with no version reference — this
release fixes that: it's built and signed with the project's own upload key,
checksummed, and provenance-signed with GPG.

Highlights

Region-ownership lock (fixes concurrent-conversion RAM stall)
Background PBF conversion (graph tiling, POI + barrier extraction, wetlands)
and the live route-planning PBF fallback could previously run concurrently
against the same region, each materializing large in-memory structures
independently. On low-RAM devices this caused native heap/swap exhaustion
and made the converter appear frozen indefinitely.

Fixed with a region-keyed lock (in-process registry + sibling lock file,
mirrored on the convert checkpoint so state survives a force-stop):

• A second background convert of a region already in progress now refuses
  cleanly instead of running alongside the first.
• A live plan needing an unbuilt region now waits on convert's lock instead
  of starting a second PBF build — closing an asymmetry where convert
  already yielded to live plans, but not the reverse.
• Fixture and production PBF paths for the same region now resolve to the
  same lock (keyed on region identity, not filesystem path), closing a gap
  where a test fixture path could bypass the guard entirely.
• Stale locks left by a killed/force-stopped process are detected and
  cleared on next acquisition, along with any leaked graph spill files from
  that process.

Progress bar known-issue documented
Added a README note explaining that phase progress percentages are set once
at phase entry, not updated continuously — so a stalled phase currently
looks identical to a nearly-finished one. Expected phase durations for a
reference region are included as a sanity baseline.

Signed release build
This release is signed with the project's own upload key (not the Android
debug certificate). Checksums and a detached GPG signature are provided
below for verification independent of the Android signature itself.

Verifying this release

apksigner verify --print-certs navi-v0.2.0-alpha.apk
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum -c SHA256SUMS

Known limitations

• Progress bar does not distinguish "phase almost done" from "phase stalled"
  (see README, Known issues).
• No F-Droid distribution yet — this release is a prerequisite step toward
  that, not F-Droid-built or F-Droid-signed.
• Alpha quality: expect rough edges outside the areas covered above.

Full changelog

See commit history since the previous unreleased state; this is the first
tagged version.

---

This discussion was created from the release ## Navi v0.2.0-alpha.