Prozess: modify-file

Zweck

Verändert einen vorhandenen Dateistand durch replace, append oder prepend.

Verantwortlichkeit

Einzige Aufgabe: Ein bestehendes File anhand des Modus deterministisch zu transformieren.

Eingaben

• path
• mode: replace | append | prepend
• content: Zusatzinhalt
• task_id: existierende Task-ID als Änderungsfreigabe

Ablauf

1. path-sandbox aufrufen.

2. Prüfen, dass Ziel eine Datei ist.

3. Dateieninhalt lesen.

4. Je Modus ausführen:

• replace: alter Inhalt wird ersetzt.
• append: old + content.
• prepend: content + old.

5. Ergebnis schreiben.

6. Erfolgsmeldung inkl. neuer Bytezahl liefern.

Vorbedingungen

• Datei existiert.
• Schreibrechte vorhanden.

Nachbedingungen

• Dateiinhalt entspricht der definierten Transformationsregel.

Fehler

• NOT_FOUND: Datei nicht vorhanden.
• VALIDATION_ERROR: ungültiger mode.
• IO_ERROR: Lese- oder Schreibfehler.
• TASK_REQUIRED / TASK_NOT_FOUND: Änderungsfreigabe fehlt oder existiert nicht.

Testfälle

• Replace ändert kompletten Inhalt.
• Append erhöht die Dateigröße exakt um content-Länge.
• Prepend setzt neue Inhalte an den Anfang.