Logging

README.md

@@ -35,18 +35,22 @@ Steuerungen → appRobotDriver → appRobotFileservice
 
 ## Dateiformat
 
-`.gcode` sieht aus wie Standard-G-Code; Zeitstempel und Cursor stehen im
-**Kommentarfeld** (`;…`, standardkonform):
+`.gcode` ist die **einzige verbindliche Positions-Abfolge** — reiner Standard-G-Code,
+nur der Aufnahme-Zeitstempel steht im **Kommentarfeld** (`;…`, standardkonform):
 
 ```
 G90 G1 x0 y300 z0 a90.00 b-90.00 c0.00 e0.00 f1000 ;1759566014
-G90 G1 x310 y444 z0.5 a90.00 b-90.00 c0.00 e6.88 f1000 ;1759566112!   <- Cursor (!)
+G90 G1 x310 y444 z0.5 a90.00 b-90.00 c0.00 e6.88 f1000 ;1759566112
 ```
 
-- `;<epoch>` = Aufnahme-Zeitstempel · abschließendes `!` = Cursor-Zeile.
+- `;<epoch>` = Aufnahme-Zeitstempel. Sonst nichts Service-Internes in der `.gcode`.
+- `<id>.json` ist ein Sidecar mit **Zusatz-Infos**: Name, Zeiten, `lineCount`,
+  `angleUnit` und der **`cursor`** (Index der zuletzt angefahrenen Zeile).
 - Der Cursor lebt zur Laufzeit als In-Memory-Index (schnelles Stepping ohne
-  Neuschreiben) und wird beim Speichern/Entladen als `!` zurückgeschrieben.
-- `<id>.json` ist ein Sidecar mit Metadaten (Name, Zeiten, `lineCount`, `angleUnit`).
+  Neuschreiben) und wird beim Speichern/Entladen ins `.json` geschrieben — die
+  `.gcode` bleibt sauber.
+- Migration: alte `.gcode`-Dateien mit `!`-Cursor-Marker werden beim ersten Lesen
+  automatisch übernommen (Marker raus, Cursor ins `.json`).
 
 ## Start