VF-Linienzug/Edit: Praeambel, Debug-Session und Edit-Attributleser buendeln

Punkt 2 (vf_linienzug.lsp) - die drei Modi teilen jetzt zwei Praeambel-Helfer
statt sie wortgleich auszuschreiben:
- vfl-dbg-session-start (schalter datei funcname sessiontext): oeffnet die
  dbg-Datei + schreibt Kopf/Session-Start. M1 haengt seinen Replay-Queue-
  Diagnose-Zusatz danach an (M1-spezifisch).
- vfl-dbg-hook-installieren: der fruehe duenne dbg-*error*-Hook (M2/M3),
  Lambda mit dynamic-scope-Vertrag wie vfl-abbruch-handler-installieren.
- vfl-frage-punkt-hoehe (punkt-key hoehe-key abbruch-key wizard-prompt):
  Startpunkt/Hoehe-Praeambel (Wizard-Hook + vfl-in-point + vfl-in-real + Z
  uebernehmen, (exit) bei Abbruch). Genutzt fuer Startpunkt in M1/M2/M3 UND
  den Endpunkt in M2 (vier Aufrufstellen, vorher 4x strukturgleich).

Punkt 3 (vf_standard.lsp / vf_etage.lsp) - der wortgleiche Attribut-Lese- +
prefill-basis-Aufbau der beiden Edit-Bodies (c:VARIOFOERDERER_EDIT,
vfe-edit-ent) in vfs-edit-basis-lesen (ent xd default-deltah default-seite)
zusammengefasst; die zwei abweichenden Defaults sind Parameter. Gibt eine
Alist (prefill-basis + Rohwerte attribs/startpunkt/hz/z-start) zurueck.
vf-konvertiere-ent BEWUSST nicht mit zusammengelegt - andere Zielstruktur
(Einzelwerte + L_VF/L_GF fuer den Batch-Konverter), Zusammenfuehrung wuerde
beide verkomplizieren.

243/243 LISP-Unit-Tests gruen; Python-Suite unveraendert zur Baseline
(11 failed); Klammerbalance geprueft. Verhaltensneutrale Extraktionen.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Lisp/vf_linienzug.lsp

@@ -2378,6 +2378,42 @@
 ;; sich um einen frischen Bau oder einen Editier-Neuaufbau handelte (kein
 ;; Sonderfall mehr noetig). Aufgerufen aus dem *error*-Handler von
 ;; vf-linienzug-modus.
+;; Debug-Session eines Modus starten - gemeinsam fuer alle drei Linienzug-Modi
+;; (frueher 3x fast wortgleich, nur Schalter-/Datei-/Funktions-/Sessiontext
+;; unterschieden sich). Oeffnet die dbg-Datei und schreibt Kopf + Session-Start.
+;; Rueckgabe: dbg-an (T, wenn geloggt wird). Der Modus-1-Zusatz (Replay-Queue-
+;; JSON-Diagnose) bleibt an M1s Aufrufstelle - er ist M1-spezifisch.
+(defun vfl-dbg-session-start (schalter datei funcname sessiontext / dbg-an)
+  (setq dbg-an (dbg-schalter-open schalter datei "DXFM_LOG"))
+  (if dbg-an
+    (progn
+      (dbgf funcname)
+      (dbgmsg sessiontext)
+      (dbgflush)))
+  dbg-an)
+
+;; Fruehen, DUENNEN dbg-*error*-Hook installieren (Modus 2/3): schliesst bei
+;; einem Abbruch waehrend der Pfad-/Praeambel-Phase (noch keine Geometrie) nur
+;; die dbg-Datei sauber und faellt auf dbg-old-error zurueck. Wird spaeter vom
+;; scharfen Wickel-Handler (vfl-abbruch-handler-installieren) abgeloest, sobald
+;; vfl-nummer/lastEnt feststehen. Frueher in M2 und M3 wortgleich ausgeschrieben.
+;; VERTRAG (dynamic scoping, wie vfl-abbruch-handler-installieren): der Aufrufer
+;; MUSS dbg-old-error und dbg-an als Locals gebunden haben; der Hook-Lambda loest
+;; sie zur Abbruchzeit gegen den Modus-Frame auf. dbg-old-error hier setzen
+;; (Save von *error*) und zurueckgeben.
+(defun vfl-dbg-hook-installieren ()
+  (setq dbg-old-error *error*)
+  (setq *error*
+    (function (lambda (msg)
+      (setq *error* dbg-old-error)
+      (if dbg-an
+        (progn
+          (dbgmsg (strcat "=== ABBRUCH: " (if msg msg "(exit)") " ==="))
+          (dbgreturn nil)
+          (dbgclose)))
+      (if dbg-old-error (dbg-old-error msg) (princ)))))
+  dbg-old-error)
+
 ;; Den scharfen Abbruch-Wickel-Handler als *error* installieren - gemeinsam
 ;; fuer alle drei Linienzug-Modi (frueher 3x wortgleich ausgeschrieben, nur der
 ;; Marker-String "linienzug"/"linienzug2"/"linienzug3" unterschied sich).
@@ -6056,6 +6092,24 @@
   (vf-set-es-masse winkel seite)
   seite)
 
+;; Punkt (XY) + Hoehe (Z) abfragen und zu einem 3D-Punkt zusammenfuehren -
+;; gemeinsame Schale fuer die frueher in vf-linienzug-modus/-modus2/-modus3
+;; strukturgleich ausgeschriebene Startpunkt-Praeambel (Wizard-Hook, vfl-in-point,
+;; vfl-in-real fuer die Hoehe, Z in die Koordinate uebernehmen). Die einzigen
+;; Unterschiede sind die drei ssg-Textschluessel (Punkt-Prompt, Hoehen-Prompt,
+;; Abbruch-Text) + der Wizard-Prompt - daher Parameter. Bricht bei nil-Punkt
+;; per (exit) ab (wie zuvor an jeder Aufrufstelle; laeuft im Modus-Frame).
+;; Rueckgabe: (x y z) mit z = abgefragte Hoehe (Default = gepickte Z).
+(defun vfl-frage-punkt-hoehe (punkt-prompt-key hoehe-prompt-key abbruch-key wizard-hoehe-prompt / pkt hoehe)
+  (if (vfl-wizard-aktiv)
+    (vl-catch-all-apply 'vflw-gruppe-punkt-hoehe-impl
+      (list punkt-prompt-key wizard-hoehe-prompt)))
+  (setq pkt (vfl-in-point nil (ssg-text punkt-prompt-key)))
+  (if (null pkt) (progn (princ (ssg-text abbruch-key)) (exit)))
+  (setq hoehe (vfl-in-real (ssg-textf hoehe-prompt-key (list (rtos (caddr pkt) 2 1)))))
+  (if (null hoehe) (setq hoehe (caddr pkt)))
+  (list (car pkt) (cadr pkt) hoehe))
+
 ;; AS-Winkel (30/90) + Seite abfragen. Gemeinsame Schale fuer die frueher
 ;; wortgleich in vf-linienzug-modus/-modus2/-modus3 UND vfl-qc-linie-mit-gf
 ;; ausgeschriebene AS-Praeambel (Winkel-Frage 30/90, Seiten-Frage links/rechts,
@@ -6444,17 +6498,16 @@
   ;; das erfasst automatisch JEDE interaktive Eingabe dieses Modus (Punkte,
   ;; Hoehen, Winkel, Menue-Auswahlen) samt Glied-Uebergaengen, ohne dass jede
   ;; einzelne Aufrufstelle im Bau-Ablauf separat instrumentiert werden muss.
-  (setq dbg-an (dbg-schalter-open "vfl-modus1" "vfl_modus1.dbg" "DXFM_LOG"))
+  (setq dbg-an (vfl-dbg-session-start "vfl-modus1" "vfl_modus1.dbg"
+                 "vf-linienzug-modus" "=== SESSION Modus 1 (Manuelle Eingabe) START ==="))
+  ;; Modus-1-Zusatz: falls dieser Lauf ein Replay ist (Editieren/Fortsetzen,
+  ;; *vfl-replay-queue* gesetzt), die EINGEHENDE Replay-Queue als JSON ausgeben -
+  ;; VOR dem Neuaufbau, daher auch bei einem Absturz mitten im Replay sichtbar
+  ;; (anders als das XDATA-JOURNAL-JSON in vfl-journal-xdata-schreiben, das erst
+  ;; nach erfolgreichem Bau laeuft). So laesst sich ein Desync direkt an der
+  ;; Eingangs-Sequenz ablesen. (M1-spezifisch, daher nicht im Session-Helfer.)
   (if dbg-an
     (progn
-      (dbgf "vf-linienzug-modus")
-      (dbgmsg "=== SESSION Modus 1 (Manuelle Eingabe) START ===")
-      ;; Diagnose: falls dieser Lauf ein Replay ist (Editieren/Fortsetzen,
-      ;; *vfl-replay-queue* gesetzt), die EINGEHENDE Replay-Queue als JSON
-      ;; ausgeben - VOR dem Neuaufbau, daher auch bei einem Absturz mitten im
-      ;; Replay sichtbar (anders als das XDATA-JOURNAL-JSON in
-      ;; vfl-journal-xdata-schreiben, das erst nach erfolgreichem Bau laeuft).
-      ;; So laesst sich ein Desync direkt an der Eingangs-Sequenz ablesen.
       (if *vfl-replay-queue*
         (dbgmsg (strcat "REPLAY-QUEUE-JSON " (vfl-journal->json *vfl-replay-queue*)))
         (dbgmsg "LIVE-BAU (kein Replay)"))
@@ -6490,16 +6543,9 @@
   ;; Locals gebunden und werden vom Handler zur Abbruchzeit dynamisch gesehen.
   (vfl-abbruch-handler-installieren "linienzug")
 
-  (if (vfl-wizard-aktiv)
-    (vl-catch-all-apply 'vflw-gruppe-punkt-hoehe-impl
-      (list "vfl-prompt-startpunkt-kette" "Starthoehe (Z, mm):")))
-  (setq startpunkt (vfl-in-point nil (ssg-text "vfl-prompt-startpunkt-kette")))
-  (if (null startpunkt) (progn (princ (ssg-text "vfl-abgebrochen")) (exit)))
-  ;; Hoehe (Z) des Startpunkts abfragen und in die Z-Koordinate uebernehmen.
-  (setq start-hoehe
-    (vfl-in-real (ssg-textf "vfl-prompt-hoehe-startpunkt-kette" (list (rtos (caddr startpunkt) 2 1)))))
-  (if (null start-hoehe) (setq start-hoehe (caddr startpunkt)))
-  (setq startpunkt (list (car startpunkt) (cadr startpunkt) start-hoehe))
+  ;; Startpunkt + Hoehe (gemeinsame Praeambel-Schale, siehe vfl-frage-punkt-hoehe).
+  (setq startpunkt (vfl-frage-punkt-hoehe "vfl-prompt-startpunkt-kette"
+                     "vfl-prompt-hoehe-startpunkt-kette" "vfl-abgebrochen" "Starthoehe (Z, mm):"))
 
   ;; Startpunkt-Erkennung VOR der AS-Frage: liegt der Punkt auf dem KS_AUS
   ;; EINES beliebigen bestehenden Kettenbausteins (GF ODER VF, beliebiges
@@ -8995,22 +9041,9 @@
   ;; eigentliche Abbruch-WICKLER (Teil-Geometrie zu einem VF_n-Block sichern)
   ;; wird erst nach dem Setup scharf geschaltet (siehe unten), sobald
   ;; vfl-nummer/lastEnt feststehen - analog Modus 2.
-  (setq dbg-an (dbg-schalter-open "vfl-modus3" "vfl_modus3.dbg" "DXFM_LOG"))
-  (if dbg-an
-    (progn
-      (dbgf "vf-linienzug-modus3")
-      (dbgmsg "=== SESSION Modus 3 (Vorwaerts-Nachbau) START ===")
-      (dbgflush)))
-  (setq dbg-old-error *error*)
-  (setq *error*
-    (function (lambda (msg)
-      (setq *error* dbg-old-error)
-      (if dbg-an
-        (progn
-          (dbgmsg (strcat "=== ABBRUCH: " (if msg msg "(exit)") " ==="))
-          (dbgreturn nil)
-          (dbgclose)))
-      (if dbg-old-error (dbg-old-error msg) (princ)))))
+  (setq dbg-an (vfl-dbg-session-start "vfl-modus3" "vfl_modus3.dbg"
+                 "vf-linienzug-modus3" "=== SESSION Modus 3 (Vorwaerts-Nachbau) START ==="))
+  (vfl-dbg-hook-installieren)
 
   (vfl-gf-abhaengigkeit-sicherstellen "vfl-m3-alert-gf-modul")
 
@@ -9021,18 +9054,9 @@
   ;; wird nur noch die abgeleitete Segment-Essenz (SEGS), nicht die Handles.
 
   ;; --- 2. Startpunkt (hoehere Seite) + Hoehe + AS-Seite ---
-  ;; Wizard: Startpunkt+Hoehe als EIN Gruppen-Dialog (analog Modus 2). Die
-  ;; unveraenderten vfl-in-point/vfl-in-real-Aufrufe konsumieren die Antworten
-  ;; danach aus *vflw-pending*.
-  (if (vfl-wizard-aktiv)
-    (vl-catch-all-apply 'vflw-gruppe-punkt-hoehe-impl
-      (list "vfl-m3-prompt-startpunkt" "Starthoehe (Z, mm):")))
-  (setq startpunkt (vfl-in-point nil (ssg-text "vfl-m3-prompt-startpunkt")))
-  (if (null startpunkt) (progn (princ (ssg-text "vfl-abgebrochen")) (exit)))
-  (setq start-hoehe (vfl-in-real (ssg-textf "vfl-prompt-hoehe-startpunkt"
-                                        (list (rtos (caddr startpunkt) 2 1)))))
-  (if (null start-hoehe) (setq start-hoehe (caddr startpunkt)))
-  (setq startpunkt (list (car startpunkt) (cadr startpunkt) start-hoehe))
+  ;; Startpunkt + Hoehe (gemeinsame Praeambel-Schale, siehe vfl-frage-punkt-hoehe).
+  (setq startpunkt (vfl-frage-punkt-hoehe "vfl-m3-prompt-startpunkt"
+                     "vfl-prompt-hoehe-startpunkt" "vfl-abgebrochen" "Starthoehe (Z, mm):"))
   ;; AS-Element (in Modus 3 immer gesetzt): Winkel(30/90) + Seite als EIN
   ;; Gruppen-Dialog. vflw-gruppe-winkel-seite-impl legt Winkel ("90"/"30")
   ;; und Seite ("1"/"2") in *vflw-pending* ab - genau die Reihenfolge, die
@@ -9544,22 +9568,9 @@
   ;; Geometrie) abgebrochen wird - die eigentliche Abbruch-Sicherung (Wickeln
   ;; der Teil-Geometrie) wird erst spaeter zu Beginn von Phase B installiert
   ;; (siehe dortiger Kommentar) und uebernimmt das Schliessen dann von hier.
-  (setq dbg-an (dbg-schalter-open "vfl-modus2" "vfl_modus2.dbg" "DXFM_LOG"))
-  (if dbg-an
-    (progn
-      (dbgf "vf-linienzug-modus2")
-      (dbgmsg "=== SESSION Modus 2 (3D-Objekte + Ziel-Hoehe) START ===")
-      (dbgflush)))
-  (setq dbg-old-error *error*)
-  (setq *error*
-    (function (lambda (msg)
-      (setq *error* dbg-old-error)
-      (if dbg-an
-        (progn
-          (dbgmsg (strcat "=== ABBRUCH: " (if msg msg "(exit)") " ==="))
-          (dbgreturn nil)
-          (dbgclose)))
-      (if dbg-old-error (dbg-old-error msg) (princ)))))
+  (setq dbg-an (vfl-dbg-session-start "vfl-modus2" "vfl_modus2.dbg"
+                 "vf-linienzug-modus2" "=== SESSION Modus 2 (3D-Objekte + Ziel-Hoehe) START ==="))
+  (vfl-dbg-hook-installieren)
 
   (vfl-gf-abhaengigkeit-sicherstellen "vfl-m3-alert-gf-modul")
 
@@ -9573,15 +9584,11 @@
   ;; Sortierung braucht, steht die Auswahl NACH der Startpunkt-Praeambel.
 
   ;; --- 2. Startpunkt + Z + AS-Seite ---
-  (if (vfl-wizard-aktiv)
-    (vl-catch-all-apply 'vflw-gruppe-punkt-hoehe-impl
-      (list "vfl-m3-prompt-startpunkt" "Starthoehe (Z, mm):")))
-  (setq startpunkt (vfl-in-point nil (ssg-text "vfl-m3-prompt-startpunkt")))
-  (if (null startpunkt) (progn (princ (ssg-text "gf-status-abgebrochen")) (exit)))
-  (setq start-hoehe (vfl-in-real (ssg-textf "vfl-prompt-hoehe-startpunkt"
-                                        (list (rtos (caddr startpunkt) 2 1)))))
-  (if (null start-hoehe) (setq start-hoehe (caddr startpunkt)))
-  (setq startpunkt (list (car startpunkt) (cadr startpunkt) start-hoehe))
+  ;; Startpunkt + Hoehe (gemeinsame Praeambel-Schale). start-hoehe wird spaeter
+  ;; vom Solver gebraucht (z-front/dH-gesamt) - aus der Z-Koordinate ziehen.
+  (setq startpunkt (vfl-frage-punkt-hoehe "vfl-m3-prompt-startpunkt"
+                     "vfl-prompt-hoehe-startpunkt" "gf-status-abgebrochen" "Starthoehe (Z, mm):"))
+  (setq start-hoehe (caddr startpunkt))
   (if (vfl-wizard-aktiv)
     (vl-catch-all-apply 'vflw-gruppe-as-impl (list "vfl-as-setzen-frage")))
   (princ (ssg-text "vfl-as-setzen-frage"))
@@ -9598,15 +9605,11 @@
   )
 
   ;; --- 3. Endpunkt + Z + ES-Seite (NEU in Modus 3) ---
-  (if (vfl-wizard-aktiv)
-    (vl-catch-all-apply 'vflw-gruppe-punkt-hoehe-impl
-      (list "vfl-m3-prompt-endpunkt" "Zielhoehe (Z, mm):")))
-  (setq endpunkt (vfl-in-point nil (ssg-text "vfl-m3-prompt-endpunkt")))
-  (if (null endpunkt) (progn (princ (ssg-text "gf-status-abgebrochen")) (exit)))
-  (setq end-hoehe (vfl-in-real (ssg-textf "vfl-m3-prompt-zielhoehe"
-                                      (list (rtos (caddr endpunkt) 2 1)))))
-  (if (null end-hoehe) (setq end-hoehe (caddr endpunkt)))
-  (setq endpunkt (list (car endpunkt) (cadr endpunkt) end-hoehe))
+  ;; Endpunkt + Zielhoehe (gemeinsame Praeambel-Schale). end-hoehe wird spaeter
+  ;; vom Solver gebraucht (z-junction/dH-gesamt) - aus der Z-Koordinate ziehen.
+  (setq endpunkt (vfl-frage-punkt-hoehe "vfl-m3-prompt-endpunkt"
+                   "vfl-m3-prompt-zielhoehe" "gf-status-abgebrochen" "Zielhoehe (Z, mm):"))
+  (setq end-hoehe (caddr endpunkt))
   (if (vfl-wizard-aktiv)
     (vl-catch-all-apply 'vflw-gruppe-as-impl (list "vfl-es-setzen-frage")))
   (princ (ssg-text "vfl-es-setzen-frage"))