Initialize Android NTP app framework

project-docs/handoff/00-START-HERE.md

@@ -0,0 +1,17 @@
+# Start Here
+
+## Project mission
+
+Build a local-first Android NTP app for comparing saved time servers, identifying the best candidate, and exporting troubleshooting evidence.
+
+## Current state
+
+Repository framework, Android skeleton, Gitea APK workflow, and initial phase plan are initialized. Product work should proceed through the phase gates in `project-docs/implementation/phase-plan.md`.
+
+## Read next
+
+1. `AGENTS.md`
+2. `project-docs/handoff/01-product-handoff.md`
+3. `project-docs/implementation/phase-plan.md`
+4. `project-docs/decisions/0001-native-android-local-first.md`
+5. `project-docs/decisions/0002-android-system-time-capability.md`

project-docs/handoff/01-product-handoff.md

@@ -0,0 +1,27 @@
+# Product Handoff
+
+## Core v1 features
+
+- Saved NTP servers: name, hostname/IP, port, notes, enabled state.
+- Profiles: Home, Customer A, Customer B, etc.
+- One-tap test all.
+- Continuous test mode intervals: 1s, 5s, 10s, 30s.
+- Per-server status: reachable, timeout, DNS failure, packet error.
+- Per-server metrics: RTT, offset estimate, stratum, reference ID, root delay, root dispersion, leap status, precision.
+- Sort by offset, latency, stratum, reachability, and health score.
+- Highlight disagreement between servers and choose a best candidate.
+- Export/share test results as text and CSV.
+- Keep short local history per server.
+- Dark/light mode.
+- Local-only privacy posture with no telemetry.
+
+## Comparison logic
+
+Poll each enabled server and compare reachability, stratum, root distance, offset stability, and median disagreement. Warnings should include unreachable server, high RTT, high root dispersion, unsynchronized stratum, leap warning, offset outlier, and reference ID changes.
+
+## Later features
+
+- SSH mode for Linux/chrony servers: `chronyc tracking`, `chronyc sources -v`, `timedatectl timesync-status`.
+- Offset/RTT graphs.
+- Alerts for drops or drift.
+- CSV/YAML import.