# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-02-08
# Nächste Prüfung: 2026-08-08

TIMER - Stoppuhr
================

Misst verstrichene Zeit. Mehrere Timer gleichzeitig möglich.

CLI-BEFEHLE
-----------

  bach timer start              Unbenannten Timer starten
  bach timer start "Recherche"  Benannten Timer starten
  bach timer stop               Letzten/einzigen Timer stoppen
  bach timer stop "Recherche"   Benannten Timer stoppen
  bach timer list               Alle aktiven Timer anzeigen
  bach timer clear              Alle Timer löschen

AUSGABE-FORMAT
--------------

  [TIMER] Recherche: 05:23 | Session: 45:12

Bei jeder CLI-Ausgabe werden aktive Timer angezeigt.

PERSISTENZ
----------

  Datei: data/.timer_state

  Inhalt:
  {
    "timers": {
      "Recherche": "2026-01-30T14:00:00",
      "Session": "2026-01-30T13:50:00"
    }
  }

BEISPIELE
---------

  # Session-Timer starten
  bach timer start "Session"
  -> Timer 'Session' gestartet

  # Zusätzlichen Timer für Teilaufgabe
  bach timer start "Bugfix"
  -> Timer 'Bugfix' gestartet

  # Status prüfen
  bach timer list
  -> Session: 45:12
  -> Bugfix:  05:23

  # Bugfix-Timer stoppen
  bach timer stop "Bugfix"
  -> Timer 'Bugfix' gestoppt: 05:23

USECASES
--------

  1. SESSION-TRACKING
     bach timer start "Session"
     ... arbeiten ...
     bach timer stop "Session"
     -> Zeigt wie lange die Session dauerte

  2. TASK-TRACKING
     bach timer start "Task-123"
     ... Task bearbeiten ...
     bach timer stop "Task-123"
     -> Zeit kann in Task-Kommentar notiert werden

  3. PARALLEL-TRACKING
     bach timer start "Gesamt"
     bach timer start "Recherche"
     ... recherchieren ...
     bach timer stop "Recherche"
     bach timer start "Coding"
     ... coden ...
     bach timer stop "Coding"
     bach timer stop "Gesamt"
     -> Zeigt Zeitverteilung

ZUSAMMENSPIEL
-------------

Timer ist Teil des Zeit-Systems:
  --help clock      Uhrzeit-Anzeige
  --help countdown  Countdown mit Trigger
  --help between    Between-Checks
  --help beat       Unified Zeit-Anzeige

---
Version: 1.0 | Status: Implementiert (v1.1.83)
Handler: system/hub/time.py (TimerHandler)
