Document the phone-weight hook's place in run_sync
Some checks failed
dependency freshness / dependencies on newest stable (push) Has been cancelled
file-length / file length <= 250 lines (push) Has been cancelled
md-naming / markdown naming convention (push) Has been cancelled
pre-commit / pre-commit (push) Has been cancelled
Tests / test (push) Has been cancelled
release-apk / release (APK) (push) Has been cancelled

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Krzysztof Rudnicki 2026-09-17 10:01:32 +02:00
parent 8e0a4bddab
commit 2984683027
2 changed files with 6 additions and 6 deletions

View File

@ -62,16 +62,16 @@ every idle tick to approximate the two moments state actually changes here.
never in the unlock handler: that runs on the Tk thread with the window up,
so a hanging call would keep the user locked in behind a successful log. It
also covers the "Synced from another device" unlock.
- Accepted trade: a PC that is on but neither logging nor locking does not
pull, so an inbound phone edit lands at the next log or lock. Bounded by slot
spacing — an unlogged day raises a lock.
- **`gate --demo` publishes too** (the call sits after the `finally`). "Safe,
closeable" means it cannot trap you at the keyboard, not that it is offline:
demo already writes real entries through `log_meal` (only the *slot* is
synthetic).
- `pull_shared_log()` is misnamed: it runs a *full* tick (pull, merge, re-sign,
persist, **push**, plus budget and both food banks), not just a pull. Use
`_sync_refresh.pull_peer_logs()` for anything a user waits on.
persist, **push**, budget, both food banks, and last the phone's weigh-in
into `w` via `_phone_weight`: `wake_alarm._weight`, lazy, never raises).
`_sync_refresh.pull_peer_logs()` is for anything a user waits on. What must
follow every tick goes in `run_sync`, not `cmd_sync` (the PC never runs it).
- Accepted trade: a PC neither logging nor locking does not pull.
- **Interactive paths must not block, and stale peers cost real time.** The
threading rules, the interactive timeout, and `prune-peers` (including the
`revs/` marker trap that made pruning *slower*) are in

View File

@ -2,7 +2,7 @@ name: diet_guard_app
description: "Companion phone app for diet_guard: log meals on the go."
publish_to: 'none'
version: 1.0.85+1
version: 1.0.86+1
environment:
sdk: ^3.12.2