gosleep/TODO.md

gosleep-timer — Go TUI Timer

Цель

Переписать timer.py на Go с модульной архитектурой, поддержкой нескольких WM/DE (niri, Hyprland, KDE), пользовательскими командами, профилями, историей, CLI-режимом и QR-экспортом.

---

Структура проекта

gosleep-timer/
├── main.go                 # CLI entrypoint
├── go.mod / go.sum
├── .gitignore
├── TODO.md
├── cicd.yaml               # CI/CD pipeline
├── .golangci.yml           # linter config
├── config/
│   ├── config.go           # загрузка YAML
│   ├── defaults.go         # дефолтные значения
│   └── types.go            # структуры Config, Module, Profile, Stage
├── engine/
│   ├── timer.go            # ядро отсчёта
│   ├── executor.go         # запуск команд, таймауты, kill
│   └── stages.go           # фазы: pre → timer → post
├── modules/
│   ├── module.go           # интерфейс Module
│   ├── registry.go         # глобальный реестр модулей
│   ├── workspace/
│   │   └── workspace.go    # переключение workspace (niri/hyprland/kde)
│   ├── media/
│   │   └── media.go        # playerctl / MPRIS
│   ├── lock/
│   │   └── lock.go         # блокировка экрана
│   ├── kill/
│   │   └── kill.go         # pkill процессов
│   ├── notify/
│   │   └── notify.go       # notify-send / dunst
│   ├── sound/
│   │   └── sound.go        # звуковой сигнал
│   ├── brightness/
│   │   └── brightness.go   # управление яркостью (brightnessctl/light)
│   ├── mute/
│   │   └── mute.go         # mute/unmute (pactl/wpctl)
│   ├── custom/
│   │   └── custom.go       # пользовательские команды pre/post
│   └── script/
│       └── script.go       # запуск произвольного скрипта
├── profiles/
│   ├── profile.go          # структура Profile
│   └── manager.go          # CRUD профилей
├── history/
│   ├── history.go          # JSONL лог запусков
│   └── stats.go            # статистика
├── tui/
│   ├── app.go              # bubbletea App
│   ├── widgets.go          # кастомные виджеты
│   ├── styles.go           # темы
│   ├── keybinds.go         # горячие клавиши
│   └── qr.go               # QR код

---

Очередность (от важного к мелкому)

[x] 1. TODO.md

Этот файл.

[ ] 2. Фундамент

• Инициализация Go модуля
• .gitignore
• Структура папок
• Первый коммит

[ ] 3. Конфиг

• config/types.go — типы данных
• config/defaults.go — дефолты
• config/config.go — парсинг YAML
• Автоопределение WM (niri/hyprland/kde/none)

[ ] 4. Ядро

• engine/timer.go — обратный отсчёт, тики
• engine/executor.go — exec.Command, таймауты, принудительное завершение
• engine/stages.go — фазы с callback-ами

[ ] 5. Модули

• modules/module.go — интерфейс
• modules/registry.go — реестр
• workspace, media, lock, kill, notify, sound, brightness, mute, custom, script

[ ] 6. Профили

• profiles/profile.go
• profiles/manager.go
• Загрузка/сохранение профилей, список, apply

[ ] 7. История

• history/history.go — запись в JSONL
• history/stats.go — агрегация

[ ] 8. TUI

• tui/app.go, widgets.go, styles.go, keybinds.go, qr.go

[ ] 9. CLI

• main.go — cobra/флаги
• Режимы: tui (по умолчанию), run, list-profiles, export, import

[ ] 10. Линтеры + CI/CD

• .golangci.yml (golint, staticcheck, gosec, revive, errcheck)
• cicd.yaml на основе cicd.example.yaml
• Go-специфичные линтеры

---

Модули (детально)

workspace

• Поле Backend (niri | hyprland | kde | auto)
• Поле Workspace (int)
• Автоопределение: loginctl, $XDG_CURRENT_DESKTOP, hyprctl, niri msg
• Команды:
  • niri: niri msg action focus-workspace {n}
  • hyprland: hyprctl dispatch workspace {n}
  • kde: qdbus org.kde.KWin /KWin setCurrentDesktop {n}

media

• Поле Action (stop | pause | play-pause | next | previous | none)
• fallback: playerctl

lock

• Поле Command (кастомная строка)
• fallback: loginctl lock-session

kill

• Поле Processes ([]string)
• pkill {name} для каждого

notify

• Поле Sound (путь к файлу или none)
• notify-send + опционально звук

sound

• Поле File (путь к wav/oga)
• paplay, aplay, ffplay

brightness

• Поле Value (int 0-100)
• brightnessctl set {n}% или light -S {n}

mute

• Поле Mute (bool)
• pactl set-sink-mute @DEFAULT_SINK@ 1 / 0
• wpctl set-mute @DEFAULT_AUDIO_SINK@ 1 / 0

custom

• Поля PreCommands, PostCommands ([]string)

script

• Поле Path (путь к скрипту)
• Аргументы из контекста таймера

---

CLI флаги (main.go)

gosleep-timer                   # TUI режим
gosleep-timer run 25m           # CLI режим
gosleep-timer run --profile work 25m
gosleep-timer list-profiles
gosleep-timer export > config.yaml
gosleep-timer import < config.yaml
gosleep-timer qr                # показать QR с конфигом

---

TUI (bubbletea)

Экраны

1. Main — ввод времени, чекбоксы модулей, выбор профиля, Start/Stop
2. Running — прогресс-бар, оставшееся время, текущий этап
3. History — последние запуски
4. Stats — статистика

Горячие клавиши

• s — Start
• S — Stop
• q / Esc — Quit
• h — History
• Tab — фокус следующий элемент
• Enter — toggle/action

---

Формат конфига (~/.config/gosleep-timer/config.yaml)

profiles:
  default:
    modules:
      workspace:
        enabled: true
        backend: auto
        workspace: 12
      media:
        enabled: true
        action: stop
      lock:
        enabled: true
        command: ""
      kill:
        enabled: false
        processes: []
      notify:
        enabled: true
        sound: ""
      sound:
        enabled: true
        file: /usr/share/sounds/freedesktop/stereo/complete.oga
      brightness:
        enabled: false
        value: 0
      mute:
        enabled: false
      custom:
        enabled: false
        pre: []
        post: []
      script:
        enabled: false
        path: ""
  work:
    extends: default
    modules:
      workspace:
        workspace: 5
  gaming:
    modules:
      kill:
        enabled: true
        processes: [firefox, slack]
      mute:
        enabled: true

---

История (~/.local/share/gosleep-timer/history.jsonl)

{"ts":"2026-07-03T01:30:00Z","profile":"default","duration":"25m","status":"completed"}
{"ts":"2026-07-03T02:00:00Z","profile":"work","duration":"1h","status":"killed"}

---

CI/CD Pipeline

На основе cicd.example.yaml:

• lint-go — golangci-lint (все линтеры)
• lint-yaml — yamllint
• lint-dockerfile — hadolint (если появится)
• build — go build
• test — go test ./...
• publish — docker образ (опционально)