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

SCAN - Task-Scanner und Verzeichnis-Analyse
=============================================

DEPRECATED: Dieser Handler bleibt für Backward-Compatibility. Neu: bach ati scan

SCAN ist ein Legacyhandler für die Verwaltung von Task-Scanning und Verzeichnis-
Analysen. Der Scanner arbeitet mit der ATI-Infrastruktur und der SQLite-Datenbank
bach.db zusammen. Moderne Scan-Operationen laufen über 'bach ati scan'.

BEFEHLE
=======

bach scan run              Scanner starten (ATI-Task-Scanner)
bach scan status           Letzten Scan-Status anzeigen
bach scan tasks            Gescannte Tasks anzeigen (--tool X für Filter)
bach scan tools            Registrierte Tools anzeigen
bach scan dir PATH         Beliebiges Verzeichnis scannen

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

RUN
---
Führt den ATI-Task-Scanner aus und scannt alle registrierten Tools nach Tasks.
Gibt Zusammenfassung aus: Tools gescannt, Tasks gefunden, neue und aktualisierte
Tasks. Speichert Ergebnisse in ati_scan_runs Tabelle (bach.db).

STATUS
------
Zeigt Status des letzten Scans aus Datenbank:
- Zeitstempel und Dauer
- Anzahl Tools und Tasks beim letzten Scan
- Gesamtstatistik: Registrierte Tools, gescannte Tasks, offene Tasks

TASKS
-----
Listet offene und in Arbeit befindliche Tasks mit Prioritäts-Sortierung.
Zeigt: Tool-Name, Task-Text (gekuerzt), Aufwand, Status, Prioritäts-Score.
Auf max. 20 Tasks beschränkt.

Mit --tool FILTER: Filtert Tasks nach Tool-Name (substring-Match).

TOOLS
-----
Listet registrierte Tools aus ati_tool_registry mit Task-Zahlen,
Status und Scan-Datum. Sortiert nach Task-Count. Max. 30 Tools.

DIR
---
Scannt ein beliebiges Verzeichnis mit DirectoryScanner (tools/dirscan.py).
Zeigt Verzeichnisbaum, Dateilisten und Dateigrößen.

BEISPIELE
=========

# Scanner starten
bach scan run

# Status prüfen
bach scan status

# Alle offenen Tasks
bach scan tasks

# Tasks eines bestimmten Tools
bach scan tasks --tool featureX

# Registrierte Tools anzeigen
bach scan tools

# Verzeichnis scannen
bach scan dir C:\Projekte\myapp
bach scan dir /c/Users/User/OneDrive

DATENQUELLEN
============

Datenbank:    data/bach.db (SQLite)
Tabellen:     ati_scan_runs, ati_tasks, ati_tool_registry
Scanner:      agents/ati/scanner/task_scanner.py (TaskScanner)
Dir-Scanner:  tools/dirscan.py (DirectoryScanner)

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

bach --help ati        ATI Agent (moderne Scan-Befehle)
bach --help builder    Build-Automatisierung
