Time card
File writtenUntil it was first read hereHours: this phone’s
A time clock stamps a card with the minute somebody clocks in, one row per day, and a week of punches is the proof that they kept turning up. This file is written about every hour by a job on a server and carried to the phone by a Shortcut, and the one thing the app can prove is that files keep arriving. So the card has seven rows, today’s at the top, each a day’s 24 hours on the phone’s clock; in each row one mark of ink at the minute a file this app has read was written, and from the mark a tail running to the minute this app first read it, which is the earliest the phone can be known to have had it. A tail that reaches the row’s end goes on from the left of the next day’s row, above. The short notch at the foot of today’s row, under the word, is now.
It is not the job’s log: the card holds only the files this app parsed on this phone, so an hourly job whose files a daily Shortcut carries shows one mark a day, and an empty day can be a job that did not run, a Shortcut that did not run, or an app that was not opened; the card cannot tell which. The tail ends at this app’s first reading, which is at or after the Shortcut’s copy and never before it: it says how long the file took to be seen here, not how long any one hop took. Two files written less than a few minutes apart share one mark. On the day the clocks change, the row still runs 00:00 to 24:00 by the wall clock, so the repeated hour draws on itself and the missing hour stays empty. The hours are the phone’s clock, while the headline is the file’s own words in UTC.
The record of readings lives in this app’s storage on this phone, holds at most 400 files, and goes when the app is removed or its storage is cleared; the card then starts again from the current file.
Data: this repository’s own refresh job; no outside source.
The file is written by this repository’s own refresh job, scripts/refresh_hello_live.py, which fetches nothing; there is no outside source and nothing to license.
Type: Ysabeau Office by Christian Thalmann (Catharsis Fonts), SIL Open Font License 1.1; a subset is in fonts/ with its license.
A workflow in the repository rewrites data/snapshot.json about every hour (the schedule is best effort, so rarely exactly on the hour), writing the time it ran as a headline, the day of the year, the week and the minute of the day, all of that one instant. A Shortcut carries the file to the phone. The app reads it again whenever it comes back to the screen and, when the file is new, adds its mark to the card.
A file is called stale after six hours without a newer one: the job writes about hourly, so six hours means a hop has not run. Asking a question about this app’s data reads the file’s own table, written by the job.