# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04


TASK-HANDLER
============

BESCHREIBUNG
============

Der Task-Handler verwaltet Aufgaben in der BACH-Datenbank. Unterstützt
Prioritäten (P1-P4), Multi-ID-Operationen, Abhängigkeiten, Zuweisungen an
Partner und Status-Management (pending/done/blocked).


OPERATIONEN
===========

add <titel>              Task hinzufügen
  Optionen: --priority P1-P4, --description TEXT, --category TEXT

list [status]            Tasks auflisten
  Status: pending (default), open (legacy), in_progress, done, blocked, all
  Optionen: --filter TERM, --assigned PARTNER, --unassigned

show <id>                Task-Details anzeigen

edit <id>                Task bearbeiten (Titel, Beschreibung, Kategorie)
  Optionen: --title TEXT, --description TEXT, --category TEXT, --assigned NAME

done <id> [id2...]       Task(s) als erledigt markieren
  Option: --note TEXT

block <id> [id2...]      Task(s) blockieren
  Option: --reason TEXT

unblock <id> [id2...]    Task(s) entblocken

reopen <id> [id2...]     Task(s) wieder öffnen (done -> pending)

delete <id> [id2...]     Task(s) löschen

priority <id> <P1-P4>    Priorität ändern

assign <id> [id2...]     Task(s) zuweisen
  Option: --to PARTNER (CLAUDE, GEMINI, COPILOT, OLLAMA, CHATGPT, etc.)

depends <id>             Abhängigkeiten verwalten
  --on <id2>       Neue Abhängigkeit hinzufügen
  --remove <id2>   Abhängigkeit entfernen
  --clear          Alle Abhängigkeiten löschen


BEISPIELE
=========

Task erstellen:
  bach task add "API implementieren" --priority P1 --category development

Tasks auflisten:
  bach task list                    # Nur pending
  bach task list in_progress        # Aktuell in Bearbeitung
  bach task list all                # Alle
  bach task list blocked --assigned GEMINI

Multi-ID-Operationen:
  bach task done 319 320 321 --note "Alle Help-Dateien erstellt"
  bach task block 100 101 --reason "Wartet auf API-Review"

Zuweisungen:
  bach task assign 100 101 --to GEMINI
  bach task list --assigned CLAUDE

Abhängigkeiten:
  bach task depends 306 --on 305    # Task 306 wartet auf 305
  bach task depends 306              # Abhängigkeiten anzeigen
  bach task depends 306 --remove 305


DATEIEN
=======

data/bach.db             SQLite-Datenbank (tasks-Tabelle)


SIEHE AUCH
==========

bach help                Allgemeine Hilfe
bach hook help           Hook-System


NOTES
=====

Multi-ID Support: Mehrere Task-IDs in einer Operation (z.B. done, block, assign)
Abhängigkeitserkennung: Tasks werden automatisch mit (BLOCKED)-Flag bei
unvollendeten Abhängigkeiten angezeigt
Hooks: after_task_create, after_task_done werden bei Operationen emittiert
