feat: Modus 3 mit optionalem AS/ES, ES-Frage vor dem Bau; Helfer rollenbasiert benannt

WARUM MODUS 3 BLEIBT
Modus 2 und 3 arbeiten beide auf einem gezeichneten Pfad (LINE/ARC), aber sie
loesen verschiedene Aufgaben:
  Modus 2 = Randwertproblem - Start UND Ziel (je X/Y/Z) sind bekannt, die
            Zwischenhoehen werden gerechnet, die Zielhoehe wird exakt
            getroffen.
  Modus 3 = Anfangswertproblem - die Kette wird mit vorgegebenen Winkeln
            vorwaerts durchgebaut, die Endhoehe ist das ERGEBNIS.
Modus 3 kann damit etwas, was Modus 2 grundsaetzlich nicht kann: ohne
vorgegebene Zielhoehe arbeiten ("folge dieser Linie mit 3 Grad und lass uns
sehen, wo wir landen") - und er hat keinen Solver, der scheitern kann.
Dazu kommt ein harter Bestandsgrund: Modus 3 schreibt ein eigenes Journal
(Marker "linienzug3") und ist per Doppelklick editierbar. Faellt der Code
weg, verlieren alle bereits damit gebauten Ketten ihren Editier-Pfad.
Der Stempel "Legacy / wird umgebaut" war ueberholt und ist raus.

MODUS 3 - DREI AENDERUNGEN (Nutzer-Vorgabe 2026-10-22)
1. "AS bauen?" und 2. "ES bauen?" sind jetzt abfragbar (vorher wurden beide
   immer gebaut), zusammen mit Winkel und Seite in je EINEM Dialog - dasselbe
   Muster, das Modus 2 schon nutzt (vflw-gruppe-as-impl), kein neuer Code.
   Ohne AS beginnt die Kette direkt am Startpunkt (flacher Rahmen statt
   Block); die Fussabdruck-Trimmung der ersten Geraden rechnet dann von
   selbst 0, weil Rahmen und Startpunkt zusammenfallen.
3. Die ES-Frage steht jetzt VOR dem Bau. Das behebt einen echten Fehler: die
   letzte Gerade wird um "Separator + ein-dx" gekuerzt, ein-dx wurde aber
   gelesen, BEVOR es gesetzt war - beim ersten Lauf griff der Schaetzwert
   *vfk-as-es-fallback-dx*, bei jedem weiteren stand dort der Wert der
   VORHERIGEN Kette (falscher Winkel, falsche Seite). Jetzt traegt die
   Trimmung den echten Fussabdruck der gewaehlten ES-Variante; ohne ES
   entfaellt sie ganz.

ABWAERTSKOMPATIBILITAET
Das Verschieben der ES-Frage aendert die Journal-Reihenfolge. Bestehende
"linienzug3"-Ketten bleiben per Doppelklick nachbaubar: alt-journal erkennt
sie am WERT des ersten Antwort-Eintrags ("30"/"90" = alt, "1"/"2" = neu, die
Mengen sind disjunkt) und spielt sie in der alten Reihenfolge ab. Dafuer der
neue Helfer vfl-replay-peek-wert neben vfl-replay-peek-art.

DIALOG vflw_as
Die Seitenauswahl wurde bei 30 Grad ausgegraut und NICHT in die Pending-Queue
gelegt - eine reine Modus-1-Regel (dort ersetzte die Zufuehrungsachse die
Seitenfrage). Modus 1 hat seit 2026-10-21 seinen eigenen Dialog; uebrig
blieben ES-Element sowie Modus 2/3, wo die Seite IMMER gebraucht wird - dort
ging bei 30 Grad ein zweites Fenster nur fuer die Seite auf. Entfernt.

NAMENSSCHEMA (faellt in denselben Commit, weil dieselbe Datei)
Die Helfer-Praefixe vfl2-/vfl3- stammten aus einer Planungsphase vor der
endgueltigen Menue-Zuordnung und waren dazu VERTAUSCHT: alle vfl3-* gehoeren
zu Modus 2, die vfl2-* zu Modus 3 - und drei davon zu BEIDEN. Eine
Modus-Nummer war fuer diese drei also gar nicht richtig vergebbar. Sie heissen
jetzt nach ihrer Rolle: vfl-zsolve-* (rechnet die Hoehen durch, nur Modus 2)
und vfl-pfad-* (arbeitet am gezeichneten Pfad, Modus 2 UND 3). 18 Funktionen,
jede Aufrufstelle maschinell gegen die Definitionen geprueft. Die falsche
Block-Ueberschrift "MODUS 3: Pfad + Ziel-Hoehe" (gemeint war Modus 2) ist
korrigiert, beide Gruppen haben jetzt einen erklaerenden Kopf.
vfl-zsolve-bruecke (frueher vfl3-solve-bruecke) wird von niemandem aufgerufen
- bewusst stehen gelassen und markiert, Loeschen gehoert in ein
Tote-Code-Review.

MENUE
Die Modi heissen jetzt nach ihrem Unterschied statt nach der Bedienung:
"aus 3D Linie mit Zielhoehe" / "aus 3D Linie ohne Zielhoehe" (vorher
"3D Objekte stueckweise (in Arbeit)").

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

doc/plan/vf-parameter-struct-analyse.md

@@ -60,7 +60,7 @@ Erweiterung (AutoLISP-Konvention: Alist statt echtem Struct):
 | `vfl-modus-abbruch-sichern` | vf_linienzug.lsp | 9 |
 | `vf-winkel-solve` | vf_core.lsp | 8 |
 | `vfs-mitte-teil`, `vfl-vf-einheit`, `vfl-vf-einheit-abschluss` | standard/linienzug | je 7 |
-| `vfs-vf-koerper`, `vfl-insert-es-element`, `vfl3-es-fueller` | standard/linienzug | je 5-6 |
+| `vfs-vf-koerper`, `vfl-insert-es-element`, `vfl-zsolve-es-fueller` | standard/linienzug | je 5-6 |
 | die vier `insert-hz-*`-Funktionen | vf_etage.lsp | je 4-6 |
 
 ## Struct-Kandidaten

doc/todo/modus2-achsenweise-bilanz.md

@@ -44,7 +44,7 @@ ganze Hoehe traegt, und rechnet die geneigte Laenge skalar:
 
 ```lisp
 ;; vf_linienzug.lsp:9990 - Solver bekommt die SKALARE Spanne
-(setq wahl3 (vfl3-waehle-winkel climber-span dH-adj feste-vf))
+(setq wahl3 (vfl-zsolve-winkel-waehlen climber-span dH-adj feste-vf))
 ;; feste-vf = Umlenk + Separator (+ Motor) -- ein fester Fussabdruck
 
 ;; vf_linienzug.lsp:10070 - Kletterer bekommt br-lvf proportional

doc/todo/plan-vf-interactive.md

@@ -149,8 +149,11 @@ Modus-uebergreifende Blocker:
 - **`ATTREQ`/`ATTDIA`**: ohne `0` fragt das `(command "_.INSERT" ...)` in den
   Einfuegeprimitiven nach Attributwerten - der wahrscheinlichste Haenger.
 
-Namensfalle: die `vfl3-*`-Helfer (:5093-5276) gehoeren zu **Modus 2**, die
-`vfl2-*`-Helfer (:4703-4804) zu **Modus 3**.
+Namensschema (seit 2026-10-22 rollenbasiert statt nach Modus-Nummer, die
+frueheren Praefixe `vfl3-`/`vfl2-` waren zur Menue-Nummerierung vertauscht):
+die `vfl-zsolve-*`-Helfer rechnen die Hoehen durch und gehoeren zu **Modus 2**;
+die `vfl-pfad-*`-Helfer arbeiten auf dem gezeichneten Pfad und werden von
+**Modus 2 UND Modus 3** genutzt.
 
 ---
 
@@ -695,7 +698,7 @@ Architektur, nicht Funktion.
 
 ### Ausdruecklich nicht anfassen
 
-`vf-linienzug-modus3` + alle `vfl2-*`; die `vfl-in-*`-Wrapper und `vfl-menu*`;
+`vf-linienzug-modus3` + alle `vfl-pfad-*`; die `vfl-in-*`-Wrapper und `vfl-menu*`;
 `vfl-entry->string` und das XDATA-Layout/die Marker; **alle Journal-Konsumenten**
 (brauchen sie Aenderungen, ist die Invariante gebrochen - das ist der
 Lackmustest); die reinen `vfs-*`/`berechne-*` in `vf_standard.lsp` (via

doc/variofoerderer.md

@@ -387,7 +387,7 @@ arbeiten auf bereits in der Zeichnung vorhandener Geometrie statt auf freier
 Klick-Eingabe — fuer eine GUI eher Import/Solver-Werkzeuge als klassische
 Formulare.
 
-### Modus 2 — Pfad + Zielhoehe (Solver)
+### Modus 2 — aus 3D Linie MIT Zielhoehe (Solver)
 
 | Feld | Steuerelement | Werte |
 |---|---|---|
@@ -400,15 +400,28 @@ Formulare.
 | -> Vario-Kurve-Variante | Dropdown | Aussen / Innen |
 | GF-Verteilung | Dropdown | alles am Einlauf (GF1) / 1/2 GF1 + 1/2 GF2 |
 
-### Modus 3 — Vorwaerts-Nachbau (Legacy, wird umgebaut)
+### Modus 3 — aus 3D Linie OHNE Zielhoehe (Vorwaerts-Bau)
+
+Baut dieselbe gezeichnete Geometrie wie Modus 2, aber VORWAERTS mit
+vorgegebenen Winkeln: die Endhoehe ist hier ein Ergebnis, kein Ziel. Genau
+das ist sein Anwendungsfall — wenn es keine feste Zielhoehe gibt.
 
 | Feld | Steuerelement | Werte |
 |---|---|---|
-| Startpunkt (3D) | Punktwahl | KS_EIN AUS-Element / Kettenanfang |
-| Gefaellewinkel | Zahl (Grad) | wird auch aus 2 gewaehlten 3D-Punkten vorgeschlagen |
-| AUS-Element Seite | Dropdown | links / rechts |
-| Separator vor EIN? | Dropdown | Ja/Nein |
-| Einfuegen bestaetigen | Dropdown | Ja/Nein |
+| Startpunkt (3D) + Starthoehe | Punktwahl + Zahl | Kettenanfang |
+| AS-Element bauen? | Ja/Nein | bei Nein beginnt die Kette direkt am Startpunkt |
+| -> AS Winkel + Seite | Dropdown | 30/90 Grad · links/rechts (ein Dialog zusammen mit "bauen?") |
+| ES-Element bauen? | Ja/Nein | **vor** dem Bau gefragt, damit der ES-Fussabdruck von der letzten Geraden abgezogen werden kann |
+| -> ES Winkel + Seite | Dropdown | 30/90 Grad · links/rechts |
+| Pfad-Objekte | Objektauswahl | Linien + Boegen der Trasse |
+| Je gerades Segment: Typ | Dropdown | GF / VF-Ab / VF-Auf / VF-Horizontal |
+| -> GF-Neigung bzw. Vario-Winkel | Zahl (Grad) | kontextabhaengig |
+| Je Bogen-Segment: Typ | Dropdown | GF-Bogen / Vario-Kurve (+ Variante) |
+
+Ketten, die vor dem 2026-10-22 gebaut wurden, kennen die beiden
+"bauen?"-Fragen noch nicht; sie werden beim Doppelklick automatisch erkannt
+und in der alten Reihenfolge nachgebaut (siehe `alt-journal` in
+`vf-linienzug-modus3`).
 
 ---