Prozess: write-file

Zweck

Schreibt Inhalt vollständig in eine Datei (Create/Overwrite).

Verantwortlichkeit

Einzige Aufgabe: Dateiatomar ersetzen/anlegen.

Eingaben

• path: Zielpfad (relativ zu FS_ROOT)
• content: neue Datei-Inhalte (UTF-8-Text)
• task_id: existierende Task-ID als Änderungsfreigabe

Ablauf

1. path-sandbox aufrufen.

2. Sicherstellen, dass Ziel kein Verzeichnis ist.

3. Elternverzeichnis existiert? Falls nicht -> automatisch anlegen (MVP erlaubt).

4. Inhalt schreiben.

5. Bei Erfolg Byteszahl zurückmelden.

Vorbedingungen

• Dateisperre/gleichzeitiger Zugriff wird im MVP nicht zusätzlich serialisiert.
• Schreibrechte auf Elternordner.

Nachbedingungen

• Dateiinhalt entspricht exakt content.
• Bei neuem Pfad: Datei erzeugt.
• Bei bestehendem Pfad: Inhalt ersetzt.

Fehler

• VALIDATION_ERROR: ungültiger Pfad.
• IO_ERROR: Schreibfehler.
• PAYLOAD_TOO_LARGE: content > 256 KiB.
• TASK_REQUIRED: keine existierende task_id angegeben.
• TASK_NOT_FOUND: task_id existiert nicht.

Testfälle

• Existierende Datei ersetzen.
• Neue Datei in neuem Unterordner schreiben (Ordner wird angelegt).
• Zu großer Body => 413.