# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ТАЙМЕР – Секундомер
----------------

Измеряет прошедшее время. Одновременно возможно использование нескольких таймеров.

КОМАНДЫ CLI
-----------

  bach timer start              Запустить безымянный таймер
  bach timer start "Recherche"  Запустить именованный таймер
  bach timer stop               Остановить последний/единственный таймер
  bach timer stop "Recherche"   Остановить именованный таймер
  bach timer list               Показать все активные таймеры
  bach timer clear              Удалить все таймеры

ФОРМАТ ВЫХОДА
--------------

  [ТАЙМЕР] Исследования: 05:23 | Сеанс: 45:12

Активные таймеры отображаются при каждом выводе CLI.

PERSISTENCY
----------

  Файл: data/.timer_state

  Содержание:
  {
    "таймеры": {
      "Исследования": "2026-01-30T14:00:00",
      "Сессия": "2026-01-30T13:50:00"
    }
  }

ПРИМЕРЫ
---------

  # Запускаем таймер сеанса
  bach timer start "Session"
  -> Таймер «Сеанс» запущен

  # Дополнительный таймер для подзадачи
  bach timer start "Bugfix"
  -> Таймер «Исправление ошибок» запущен

  # Проверить статус
  bach timer list
  -> Сессия: 45:12
  -> Исправление ошибки: 05:23

  # Остановить таймер исправления ошибок
  bach timer stop "Bugfix"
  -> Таймер «Исправление ошибки» остановлен: 05:23

USECASES
--------

  1. ОТСЛЕЖИВАНИЕ СЕАНСА
     bach timer start "Session"
     ... работа ...
     bach timer stop "Session"
     -> Показывает, как долго длился сеанс

  2. ОТСЛЕЖИВАНИЕ ЗАДАЧ
     bach timer start "Task-123"
     ... Редактировать задачу ...
     bach timer stop "Task-123"
     -> Время можно указать в комментарии к задаче

  3. ПАРАЛЛЕЛЬНОЕ СЛЕЖЕНИЕ
     bach timer start "Gesamt"
     bach timer start "Recherche"
     ...исследования...
     bach timer stop "Recherche"
     bach timer start "Coding"
     ... код ...
     bach timer stop "Coding"
     bach timer stop "Gesamt"
     -> Показывает распределение времени

INTERPLAY
-------------

Таймер является частью системы времени:
  --help clock Отображение времени
  --help обратный отсчет Обратный отсчет с триггером
  --help между проверками
  --help победить Единое отображение времени

---
Версия: 1.0 | Статус: Реализовано (v1.1.83)
Обработчик: system/hub/time.py (TimerHandler)
