Prozess: delete-file

Zweck

Löscht genau eine vorhandene Datei innerhalb des Sandbox-Bereichs.

Verantwortlichkeit

Einzige Aufgabe: einen erlaubten regulären Dateipfad kontrolliert entfernen.

Eingaben

• path: relativer Dateipfad innerhalb von FS_ROOT.
• task_id: existierende Task-ID als Änderungsfreigabe.

Ablauf

1. path-sandbox aufrufen.

2. Prüfen, dass der Zielpfad eine reguläre Datei ist.

3. Datei mit unlink löschen.

4. Erfolgsantwort mit relativem Pfad und deleted=true liefern.

Vorbedingungen

• Datei existiert.
• Der Laufzeitbenutzer besitzt Löschrechte im Elternordner.

Nachbedingungen

• Die Datei ist nicht mehr vorhanden.
• Kein anderer Pfad und kein Ordner wird gelöscht.

Fehler

• PATH_FORBIDDEN: Pfad liegt außerhalb der Sandbox.
• VALIDATION_ERROR: Pfad ist leer oder ungültig.
• NOT_FOUND: Datei existiert nicht oder ist kein reguläres File.
• IO_ERROR: Dateisystem verweigert das Löschen.
• TASK_REQUIRED / TASK_NOT_FOUND: Änderungsfreigabe fehlt oder existiert nicht.

Testfälle

• Vorhandene Datei löschen => 200 und deleted=true.
• Nicht vorhandene Datei => NOT_FOUND.
• ../secret.txt => PATH_FORBIDDEN.