main was red on file length, the noqa ban, codespell, test naming and dart coverage; this change touches every one of those jobs. - sickdays: set_enabled is keyword-only; the panel test splits in two with shared probes; the sync wire format moves to DOCS-sync.md. - earned_time: _focus types the project as a Protocol, no noqa; the gate-maturity section moves to DOCS-maturity.md; codespell knows the `checkin` event name. - focus_project: real fixes for every noqa (local-day clocks, typed fakes, logged broad catches, split helpers). The public API that focus-guard calls keeps its signatures; their PLR0913 exemption lives in pyproject with the reason, not in noqa. - crdt-sync: pylint gets nacl/argon2, docstrings, and allows the public E2eLayout.of; _blobs moves to _e2e_blobs.py. - crdt_sync_dart: Argon2Params and the header errors move to e2e_params.dart (re-exported); tests split and reach 100% lines. - sql_drills: test helpers get a leading underscore, as in earned_time. Todo: fda71ed1 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| sickdays | ||
| systemd | ||
| .pre-commit-config.yaml | ||
| DOCS-sync.md | ||
| install.sh | ||
| pyproject.toml | ||
| README.md | ||
| requirements.txt | ||
| sickdays.desktop | ||
sickdays
One shared pool of sick days that every gate respects.
Every day is a normal day until it is marked sick. There is no cap, no budget, no reason to give and no countdown. The one rule is the calendar: only today or a later day can be marked or un-marked — never a past one.
This replaces screen-locker's capped sick day (rolling windows, 120-character
justifications). It is not the free-day pool: freedays is a separate
pool with its own file and remote node, and a date is never in both.
For a gate app
import sickdays
if sickdays.is_sick_day(today): # default: today
... # apply this gate's sick-day rules
is_sick_day() reads one local JSON file, never the network, and never
raises. A missing file means "no sick days". An unreadable or corrupt file
is logged as a warning and also reads as not sick: it fails closed, so the
alarm rings and the locks apply.
Keeping some lockers on a sick day (0.2.0)
A sick day may keep some lockers active. A locker stands down on a day iff the day is sick and the locker is not in that day's keep set. A gate that is one of the lockers asks the narrower question:
if sickdays.stands_down(sickdays.LOCKER_LEETCODE): # default: today
... # this locker is off today
Locker ids (LOCKER_* constants): workout, leetcode, book, diet,
alarm. alarm is one switch for the phone ring, the PC fallback ring, the
RTC self-wake and the missed-alarm penalty.
LOCKERS is all five, in that order. stands_down never raises for a data
problem (only ValueError for an id not in LOCKERS). Every doubt answers
"the locks apply": an unreadable pool is not sick, a malformed keep set keeps
every locker. is_sick_day is unchanged, so a gate still on the 0.1.0 API
keeps working and treats every sick day as "everything stands down".
For a person
$ sickdays add # today
$ sickdays add 2026-10-20 # or 'tomorrow'
$ sickdays add tomorrow --keep leetcode --keep workout # those two stay on
$ sickdays keep 2026-10-20 diet # replace the kept set of a sick day
$ sickdays keep 2026-10-20 # keep nothing: every locker stands down again
$ sickdays remove 2026-10-20 # today or later only
$ sickdays list # every sick day, oldest first
2026-10-16 (today)
2026-10-20 keep: diet
$ sickdays check tomorrow # exit 0 if sick, 1 if not -- for scripts
$ sickdays check --locker alarm # exit 0 iff that locker stands down today
$ sickdays sync # pull and push now
python -m sickdays ... is the same command. Exit codes: 0 done, 1
refused (past day, already sick, not sick, a free day, sync unavailable),
2 input not understood (a bad date, or a locker id not in LOCKERS --
--keep, keep and --locker only accept the five ids).
The picker window (0.3.0)
sickdays gui (or the "Sick days" launcher): the phone's Sick days screen on
Tk -- calendar, a six-switch panel per day, the days ahead. Past days are
inert; a free day is refused; each write starts sync_quietly() on a
non-daemon thread. WM_CLASS "sickdays", "Sickdays"; Escape closes. Embed
just the panel (import sickdays never imports tkinter):
No words inside the window (textgate): dates are ISO numerals (2026-11,
2026-11-27), each locker is a drawn pictogram (dumbbell = workout, </> =
LeetCode, open book, apple = diet, alarm clock, target = focus), switches are
knob-right-on-accent / knob-left-on-dark, buttons are check (mark / save),
red bin (clear) and cross (cancel). A refusal is an icon in the status slot:
padlock (past), no-entry (free day), warning (cannot check, or a refused
write; the detail goes to the log), hourglass (a sync is still running).
Icons are Canvas geometry, not font glyphs: the venv's Tk uses core X fonts,
where non-ASCII glyphs render as nothing. The title bar keeps "Sick days"
(an app's name, textgate settled decision 4). The guard is
tests/test_gui_no_words.py: no letter on any widget, in any state.
from sickdays.gui import KeepPanel # a plain tk.Frame: no root, grab or wm_* call
KeepPanel(parent, day, *, on_saved, on_cancel=None, paths=None).pack()
Normal day: six switches, all off (off = stands down), actions.mark; sick
day: its switches, actions.save, actions.clear. Past/free/uncheckable
days show their icon and offer no write; a refusal (or a click mid-sync)
shows in the panel's status slot, named by panel.reason.
on_saved(SickDay | None) fires after the write and sync start: the entry on
mark / a changed save (is_sick=True) or clear (is_sick=False), None
on an unchanged save (nothing written). The panel never destroys itself.
API
| call | does |
|---|---|
is_sick_day(day=None, *, log_path=None, now=None) -> bool |
the gate question; never raises |
sick_days(*, log_path=None) -> frozenset[date] |
every date currently sick |
stands_down(locker, day=None, *, log_path=None, now=None) -> bool |
the per-locker gate question; never raises for data, ValueError for an unknown id |
kept_lockers(day=None, *, log_path=None, now=None) -> frozenset[str] |
the day's kept lockers; empty when not sick |
add_sick_day(day, *, keep=(), is_free=None, paths=None, now=None) -> SickDay |
today or later; refuses a free day; ValueError on an unknown locker |
set_kept_lockers(day, keep, *, paths=None, now=None) -> SickDay |
replace an existing sick day's kept set; today or later |
remove_sick_day(day, *, paths=None, now=None) -> SickDay |
today or later |
import_legacy(days, *, paths=None) -> list[date] |
migration only: may write past dates; idempotent |
ensure_not_sick(day, *, paths=None) |
for freedays' callers, before freedays.mark |
sync(), sync_quietly() |
one pull/merge/push tick |
SickDay is (day, is_sick, actor="", keep=frozenset()). The locker ids are
LOCKER_WORKOUT, LOCKER_LEETCODE, LOCKER_BOOK, LOCKER_DIET,
LOCKER_ALARM and the tuple LOCKERS.
Refusals subclass SickDayError: PastDateError, AlreadySickError,
NotSickError, FreeDayConflictError, SickDayConflictError,
ConflictCheckUnavailableError, UnreadablePoolError. Writers refuse an
existing-but-corrupt pool (UnreadablePoolError) instead of overwriting it
with an empty one; sync reads it as empty, so a peer's copy restores it.
import_legacy is for screen-locker's sick_history.json (2026-06-21 and
2026-07-24, both before every gate start). It skips the free-day check.
A date is never in both pools
Neither package imports the other at module level, so they can never form an import cycle:
- Adding a sick day checks a predicate
is_free(day) -> bool. By defaultadd_sick_dayimportsfreedayslazily, by name, at call time (_conflict.free_day_predicate). If freedays is not importable the add is refused (ConflictCheckUnavailableError). The invariant is hard, so "could not check" never counts as "not free". A phone port or a test passes its ownis_free. - Marking a free day is freedays' write. Its callers (CLIs, phone, lock
screen) call
sickdays.ensure_not_sick(day)first. That needs no freedays import at all. freedays itself does not check yet.
Storage
| what | where |
|---|---|
| the pool | ~/.local/share/sickdays/sick_days.json |
| device uuid (per install) | ~/.local/share/sickdays/device_id |
audit trail (HMAC-signed, append-only; actions add, remove, keep, import) |
~/.local/share/sickdays/audit.jsonl + hmac.key |
| sync bookkeeping (local only) | ~/.local/share/sickdays/sync_state.json |
Days are local calendar dates (_day.today()), the same as freedays.
Sync and the wire format (for the phone)
Firebase RTDB through crdt-sync, one directory per device. The paths, record layout and merge rules the phone must match are in DOCS-sync.md.
Install
$ ./install.sh # own venv (crdt-sync + freedays + sickdays), CLI on PATH, launcher, 15-min sync timer
$ ./install.sh --no-timer
Development
$ pip install ../crdt-sync && pip install --no-deps ../freedays
$ pip install -r requirements.txt && pip install --no-deps -e .
$ xvfb-run -a python -m pytest # 100% branch coverage; the GUI tests need a display
$ pre-commit run --config sickdays/.pre-commit-config.yaml --all-files # from the repo root