kuhyx/utils
1
0
Fork 0
mirror of https://github.com/kuhyx/utils.git synced 2026-11-10 19:07:17 +01:00
Code Issues Actions 14 Packages Projects Releases Wiki Activity
6d80efb50a
utils/focus_project
History
Krzysztof kuhy Rudnicki 6d80efb50a focus_project: minutes, ledger, harvester 
Fail-closed: a failing source logs and adds 0 minutes;
a bad key, ledger or registry exits 1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWYcmik6APnHfc9gEVy
2026-11-02 08:19:01 +01:00
..
focus_project focus_project: minutes, ledger, harvester 2026-11-02 08:19:01 +01:00
systemd focus_project: minutes, ledger, harvester 2026-11-02 08:19:01 +01:00
.pre-commit-config.yaml focus_project: registry, stands_down, activity 2026-11-02 08:13:52 +01:00
install_harvest.sh focus_project: minutes, ledger, harvester 2026-11-02 08:19:01 +01:00
install.sh focus_project: registry, stands_down, activity 2026-11-02 08:13:52 +01:00
pyproject.toml focus_project: registry, stands_down, activity 2026-11-02 08:13:52 +01:00
README.md focus_project: registry, stands_down, activity 2026-11-02 08:13:52 +01:00
requirements.txt focus_project: registry, stands_down, activity 2026-11-02 08:13:52 +01:00

README.md

focus_project

Time-boxed focus projects ("until Thursday I prepare for X"). The active project switches chosen gates off and defines a daily-minutes gate.

import focus_project as fp

fp.stands_down("leetcode", today)   # gate in leetcode|book|reading|tutor; never raises
fp.active(today)                    # Project | None
fp.status(today)                    # dict for i3bar / GUIs
fp.record_activity("timer", "start")

Data: $FOCUS_PROJECT_DATA or ~/.local/share/focus_project/ (projects.json, activity.jsonl). minutes.py is owned by the minutes/harvester agent. Install: ./install.sh (stdlib only, editable user install for /usr/bin/python3).